<div class="content"><p> </p><p>The I_nsi_ping_locator method is invoked by the client to
determine if the target computer is available as a <span><a href="55ec267c-87d9-4d97-a9d5-5681f5f283b8#gt_a33485fd-4392-4219-83f8-d65cfa0e9674" data-linktype="relative-path">master locator</a></span>. The <span><a href="55ec267c-87d9-4d97-a9d5-5681f5f283b8#gt_9c5903c1-1477-4181-b451-3ba1e34a0c0c" data-linktype="relative-path">MIDL</a></span>
syntax of the method is specified as follows.</p><dl>
<dd>
<div><pre> void I_nsi_ping_locator(
   [in] handle_t hLocatortoPing,
   [out] error_status_t* status
 );
</pre></div>
</dd></dl><p><b>hLocatortoPing: </b>An <span><a href="55ec267c-87d9-4d97-a9d5-5681f5f283b8#gt_8a7f6700-8311-45bc-af10-82e10accd331" data-linktype="relative-path">RPC</a></span> primitive <span><a href="55ec267c-87d9-4d97-a9d5-5681f5f283b8#gt_1cf35308-abab-4123-9cbd-99c42dc9a6ff" data-linktype="relative-path">binding</a></span>
handle, as specified in <span><a href="https://go.microsoft.com/fwlink/?LinkId=89824" data-linktype="external">[C706]</a></span> Part 2,
&#34;Binding Handle&#34;. A client creates this handle by binding to the
locator server using a UUID specified in section <span><a href="e3c9c694-f896-46b9-9452-097f53e0c03f" data-linktype="relative-path">1.9</a></span> and an endpoint
specified in section <span><a href="f6ef0bc1-f32e-45ef-bcfb-bcbd0d08c71d" data-linktype="relative-path">2.1</a></span> using the <b>rpc_string_binding_compose</b>
and <b>rpc_binding_from_string_binding</b> APIs [C706] or equivalent on the
client systems implementation of RPC.</p><p><b>status: </b>A 32-bit value that indicates the
results of the method call. In case of success, the value will contain
NSI_S_OK, or a nonzero value on failure. All failures MUST be treated
identically as a failure of the pinging process initiated by this method, and
the target computer SHOULD be treated as unavailable as a master locator.<a id="Appendix_A_Target_10"></a><a aria-label="Product behavior note 10" href="c3f4113b-48f1-4395-9284-ee937948047b#Appendix_A_10" data-linktype="relative-path">&lt;10&gt;</a></p><p><b>Return Values: </b>This method does not return any
values.</p><p>Exceptions Thrown</p><p>No exceptions are thrown beyond those thrown by the
underlying RPC protocol, as specified in <span><a href="../ms-rpce/290c38b1-92fe-4229-91e6-4fc376610c15" data-linktype="relative-path">[MS-RPCE]</a></span>.</p></div>