<div class="content" name="ApiRestartResource" uuid="76e40880-02bd-4f2e-93bd-0ffba1b10c6b"><p>The ApiRestartResource method SHOULD<a id="Appendix_A_Target_129"></a><a aria-label="Product behavior note 129" href="1d58eff8-a042-478c-972c-8e9c76a3f978#Appendix_A_129" data-linktype="relative-path">&lt;129&gt;</a> instruct the server to
restart a resource without affecting the resource&#39;s persistent state. The
server SHOULD bring the resource offline, then bring the resource back to its
persistent state.</p><p>The server MUST accept an ApiRestartResource request only if
it is in the read/write state, as specified in section <span><a href="756547e7-ca64-4b7c-9f1b-2b1fbc6153d3" data-linktype="relative-path">3.1.1</a></span>.</p><p>The server MUST require that the access level associated
with the <i>hResource</i> parameter is &#34;All&#34; (section <span><a href="a249a463-3d3b-4058-abf6-3024d81806a0" data-linktype="relative-path">3.1.4</a></span>).</p><dl>
<dd>
<div><pre> error_status_t ApiRestartResource(
   [in] HRES_RPC hResource,
   [in] DWORD dwFlags,
   [out] error_status_t *rpc_status
 );
</pre></div>
</dd></dl><p><b>hResource: </b>An HRES_RPC context handle that was
obtained in a previous call to <span><a href="181f8de0-f518-4c5b-b98e-ddb18aa325ce" data-linktype="relative-path">ApiOpenResource (section 3.1.4.2.9)</a></span>,
<span><a href="6595931d-2fe5-4097-9270-f6bada5d9242" data-linktype="relative-path">ApiOpenResourceEx (section 3.1.4.2.119)</a></span>,
or <span><a href="bc6ca940-7177-4bef-9567-ae4a692a2ba5" data-linktype="relative-path">ApiCreateResource (section 3.1.4.2.10)</a></span>.</p><p><b>dwFlags: </b>This field is reserved and is ignored
by the server. Clients MUST set this value to 0.</p><p><b>rpc_status: </b>A 32-bit integer used to indicate
success or failure. The <span><a href="694e5e7a-5833-4f3d-b47e-323ee1d452c2#gt_8a7f6700-8311-45bc-af10-82e10accd331" data-linktype="relative-path">RPC</a></span> runtime MUST
indicate, by writing to this parameter, whether it succeeded in executing this
method on the server. The encoding of the value passed in this parameter MUST
conform to encoding for comm_status and fault_status, as specified in Appendix
E of <span><a href="https://go.microsoft.com/fwlink/?LinkId=89824" data-linktype="external">[C706]</a></span>.</p><p><b>Return Values: </b>This method MUST return
ERROR_SUCCESS (0x00000000) on success, or a different value for any other
condition. Clients MUST treat all values other than ERROR_SUCCESS identically,
except for recoverable errors as specified in section <span><a href="ca75805a-4b39-4074-8b5b-dbaae6e81b1f" data-linktype="relative-path">3.2.4.6</a></span>, for which
the client MUST initiate the reconnect procedure.</p></div>