<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.win32service.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'function.win32-set-service-exit-code.php',
    1 => 'win32_set_service_exit_code',
    2 => 'Определяет или возвращает код выхода для текущей запущенной службы',
  ),
  'up' => 
  array (
    0 => 'ref.win32service.php',
    1 => 'win32service',
  ),
  'prev' => 
  array (
    0 => 'function.win32-send-custom-control.php',
    1 => 'win32_send_custom_control',
  ),
  'next' => 
  array (
    0 => 'function.win32-set-service-exit-mode.php',
    1 => 'win32_set_service_exit_mode',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'reference/win32service/functions/win32-set-service-exit-code.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.win32-set-service-exit-code" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">win32_set_service_exit_code</h1>
  <p class="verinfo">(PECL win32service &gt;=0.4.0)</p><p class="refpurpose"><span class="refname">win32_set_service_exit_code</span> &mdash; <span class="dc-title">Определяет или возвращает код выхода для текущей запущенной службы</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.win32-set-service-exit-code-description">
  <h3 class="title">Описание</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>win32_set_service_exit_code</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$exitCode</code><span class="initializer"> = 1</span></span>): <span class="type"><a href="language.types.integer.php" class="type int">int</a></span></div>

  <p class="para rdfs-comment">
   Функция изменяет или возвращает код выхода. Код выхода используется, только если режим выхода не изящный.
   Если значение не равно нулю, конфигурацию восстановления можно использовать после сбоя обслуживания.
   Дополнительную информацию даёт описание
   <a href="https://docs.microsoft.com/en-us/windows/desktop/debug/system-error-codes" class="link external">&raquo;&nbsp;кодов системных ошибок Microsoft</a>.
  </p>

  <div class="caution"><strong class="caution">Предостережение</strong>
   <p class="para">
    Функция работает только через SAPI-интерфейс CLI.
    Через другие SAPI-интерфейсы функция не работает.
   </p>
  </div>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.win32-set-service-exit-code-parameters">
  <h3 class="title">Список параметров</h3>
  <dl>
   
    <dt><code class="parameter">exitCode</code></dt>
    <dd>
     <p class="para">
      Код возврата, используемый при выходе.
     </p>
    </dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.win32-set-service-exit-code-returnvalues">
  <h3 class="title">Возвращаемые значения</h3>
  <p class="para">
   Функция возвращает текущий или старый код выхода.
  </p>
 </div>


 <div class="refsect1 errors" id="refsect1-function.win32-set-service-exit-code-errors">
  <h3 class="title">Ошибки</h3>
  <p class="para">
   До версии 1.0.0 функция выдавала ошибку уровня <strong><code><a href="errorfunc.constants.php#constant.e-error">E_ERROR</a></code></strong>
   при вызове не через SAPI-интерфейс <code class="literal">&quot;cli&quot;</code>.
  </p>
   <p class="para">
    С версии 1.0.0 функция выбрасывает исключение <span class="classname"><a href="class.win32serviceexception.php" class="classname">Win32ServiceException</a></span>
    при вызове не через SAPI-интерфейс <code class="literal">&quot;cli&quot;</code>.
   </p>
 </div>


 <div class="refsect1 changelog" id="refsect1-function.win32-set-service-exit-code-changelog">
  <h3 class="title">Список изменений</h3>
  <p class="para">
   <table class="doctable informaltable">
    
     <thead>
      <tr>
       <th>Версия</th>
       <th>Описание</th>
      </tr>

     </thead>

     <tbody class="tbody">
      <tr>
       <td>PECL-модуль win32service 1.0.0</td>
       <td>
        Функция выбрасывает исключение <span class="classname"><a href="class.valueerror.php" class="classname">ValueError</a></span> при недопустимых данных в параметрах,
        раньше возвращалось <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>.
       </td>
      </tr>

      <tr>
       <td>PECL-модуль win32service 1.0.0</td>
       <td>
        Функция выбрасывает исключение <span class="classname"><a href="class.win32serviceexception.php" class="classname">Win32ServiceException</a></span>, если возникла ошибка,
        раньше возвращался
        <a href="win32service.constants.php#win32service.constants.errors" class="link">код ошибки Win32</a>.
       </td>
      </tr>

     </tbody>
    
   </table>

  </p>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.win32-set-service-exit-code-seealso">
  <h3 class="title">Смотрите также</h3>
  <ul class="simplelist">
    <li><span class="function"><a href="function.win32-start-service-ctrl-dispatcher.php" class="function" rel="rdfs-seeAlso">win32_start_service_ctrl_dispatcher()</a> - Регистрирует скрипт в Диспетчере управления службами, чтобы он действовал как служба с заданным именем</span></li>
    <li><span class="function"><a href="function.win32-set-service-status.php" class="function" rel="rdfs-seeAlso">win32_set_service_status()</a> - Обновляет статус службы</span></li>
    <li><span class="function"><a href="function.win32-set-service-exit-mode.php" class="function" rel="rdfs-seeAlso">win32_set_service_exit_mode()</a> - Определяет или возвращает режим выхода для текущей запущенной службы</span></li>
  </ul>
 </div>


</div><?php manual_footer($setup); ?>