<!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>Deletes a service entry from the SCM database</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.win32-create-service.html">win32_create_service</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.win32-get-last-control-message.html">win32_get_last_control_message</a></div>
<div class="up"><a href="ref.win32service.html">win32service Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.win32-delete-service" class="refentry">
<div class="refnamediv">
<h1 class="refname">win32_delete_service</h1>
<p class="verinfo">(PECL win32service SVN)</p><p class="refpurpose"><span class="refname">win32_delete_service</span> — <span class="dc-title">Deletes a service entry from the SCM database</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.win32-delete-service-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="type"><a href="language.pseudo-types.html#language.types.mixed" class="type mixed">mixed</a></span> <span class="methodname"><strong>win32_delete_service</strong></span>
( <span class="methodparam"><span class="type">string</span> <code class="parameter">$servicename</code></span>
[, <span class="methodparam"><span class="type">string</span> <code class="parameter">$machine</code></span>
] )</div>
<p class="para rdfs-comment">
Attempts to delete a service from the SCM database. Administrative
privileges are required for this to succeed.
</p>
<p class="para">
This function really just marks the service for deletion. If other
processes (such as the Services Applet) are open, then the deletion will be
deferred until those applications are closed. If a service is marked for
deletion, further attempts to delete it will fail, and attempts to create a
new service with that name will also fail.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.win32-delete-service-parameters">
<h3 class="title">Parameters</h3>
<p class="para">
<dl>
<dt>
<span class="term"><em><code class="parameter">servicename</code></em></span>
<dd>
<p class="para">
The short name of the service.
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">machine</code></em></span>
<dd>
<p class="para">
The optional machine name. If omitted, the local machine will be used.
</p>
</dd>
</dt>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.win32-delete-service-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
Returns <strong><code>WIN32_NO_ERROR</code></strong> on success, <strong><code>FALSE</code></strong> if there is a problem with the parameters or a <a href="win32service.constants.errors.html" class="link">Win32 Error Code</a> on failure.
</p>
</div>
<div class="refsect1 examples" id="refsect1-function.win32-delete-service-examples">
<h3 class="title">Examples</h3>
<p class="para">
<div class="example" id="example-5391">
<p><strong>Example #1 A <span class="function"><strong>win32_delete_service()</strong></span> example</strong></p>
<div class="example-contents"><p>
Deletes the dummyphp service.
</p></div>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br />win32_delete_service</span><span style="color: #007700">(</span><span style="color: #DD0000">'dummyphp'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
</div>
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.win32-delete-service-seealso">
<h3 class="title">See Also</h3>
<p class="para">
<ul class="simplelist">
<li class="member"> <span class="function"><a href="function.win32-create-service.html" class="function" rel="rdfs-seeAlso">win32_create_service()</a> - Creates a new service entry in the SCM database</span></li>
<li class="member"><a href="win32service.constants.errors.html" class="link">Win32 Error Codes</a></li>
</ul>
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.win32-create-service.html">win32_create_service</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.win32-get-last-control-message.html">win32_get_last_control_message</a></div>
<div class="up"><a href="ref.win32service.html">win32service Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
