uTools-Manuals/docs/php/win32_get_last_control_message.html
2019-04-08 23:22:26 +08:00

103 lines
4.3 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Returns the last control message that was sent to this service</title>
</head>
<body class="docs"><div id="layout">
<div id="layout-content"><div id="function.win32-get-last-control-message" class="refentry">
<div class="refnamediv">
<h1 class="refname">win32_get_last_control_message</h1>
<p class="verinfo">(PECL win32service &gt;=0.1.0)</p><p class="refpurpose"><span class="refname">win32_get_last_control_message</span> &mdash; <span class="dc-title">Returns the last control message that was sent to this service</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.win32-get-last-control-message-description">
<h3 class="title">说明</h3>
<div class="methodsynopsis dc-description">
<span class="methodname"><strong>win32_get_last_control_message</strong></span>
( <span class="methodparam">void</span>
) : <span class="type">int</span></div>
<p class="para rdfs-comment">
Returns the control code that was last sent to this service process.
When running as a service you should periodically check this to determine if
your service needs to stop running.
</p>
<div class="caution"><strong class="caution">Caution</strong>
<p class="para">
Since version 0.2.0, this function work only in &quot;cli&quot; SAPI. On other SAPI
this function is disabled.
</p>
</div>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.win32-get-last-control-message-returnvalues">
<h3 class="title">返回值</h3>
<p class="para">
Returns a control constant which will be one of the
<a href="win32service.constants.servicecontrol.html" class="link">Win32Service Service Control Message Constants</a>:
<strong><code>WIN32_SERVICE_CONTROL_CONTINUE</code></strong>,
<strong><code>WIN32_SERVICE_CONTROL_INTERROGATE</code></strong>,
<strong><code>WIN32_SERVICE_CONTROL_PAUSE</code></strong>,
<strong><code>WIN32_SERVICE_CONTROL_PRESHUTDOWN</code></strong>,
<strong><code>WIN32_SERVICE_CONTROL_SHUTDOWN</code></strong>,
<strong><code>WIN32_SERVICE_CONTROL_STOP</code></strong>.
</p>
</div>
<div class="refsect1 errors" id="refsect1-function.win32-get-last-control-message-errors">
<h3 class="title">错误/异常</h3>
<p class="para">
If SAPI is not <em>&quot;cli&quot;</em>, this function emits an <strong><code>E_ERROR</code></strong> level error.
</p>
</div>
<div class="refsect1 changelog" id="refsect1-function.win32-get-last-control-message-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>0.2.0</td>
<td>
This function works only in the <em>&quot;cli&quot;</em> SAPI.
</td>
</tr>
</tbody>
</table>
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.win32-get-last-control-message-seealso">
<h3 class="title">参见</h3>
<p class="para">
<ul class="simplelist">
<li class="member"><span class="function"><a href="win32_start_service_ctrl_dispatcher.html" class="function" rel="rdfs-seeAlso">win32_start_service_ctrl_dispatcher()</a> - Registers the script with the SCM, so that it can act as the service with the given name</span></li>
<li class="member"><span class="function"><a href="win32_set_service_status.html" class="function" rel="rdfs-seeAlso">win32_set_service_status()</a> - Update the service status</span></li>
<li class="member"><span class="function"><a href="win32_set_service_exit_mode.html" class="function" rel="rdfs-seeAlso">win32_set_service_exit_mode()</a> - Define or return the exit mode for the current running service</span></li>
<li class="member"><span class="function"><a href="win32_set_service_exit_code.html" class="function" rel="rdfs-seeAlso">win32_set_service_exit_code()</a> - Define or return the exit code for the current running service</span></li>
<li class="member"><a href="win32service.constants.servicecontrol.html" class="link">Win32Service Service Control Message Constants</a></li>
</ul>
</p>
</div>
</div></div></div></body></html>