<div class="content"><p> </p><p>The I_nsi_entry_object_inq_begin method is invoked to
enumerate the <span><a href="55ec267c-87d9-4d97-a9d5-5681f5f283b8#gt_0a38e28d-7525-4d2d-8c62-43aedaf47b74" data-linktype="relative-path">object UUIDs</a></span> on a <span><a href="55ec267c-87d9-4d97-a9d5-5681f5f283b8#gt_6cfe4abe-94bd-43b6-b666-3618d9093373" data-linktype="relative-path">name
service entry</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_entry_object_inq_begin(
   [in] handle_t hrpcPrimaryLocatorHndl,
   [in] unsigned long EntryNameSyntax,
   [in] STRING_T EntryName,
   [out] NSI_NS_HANDLE_T* InqContext,
   [out] unsigned short* status
 );
</pre></div>
</dd></dl><p><b>hrpcPrimaryLocatorHndl: </b>An <span><a href="55ec267c-87d9-4d97-a9d5-5681f5f283b8#gt_8a7f6700-8311-45bc-af10-82e10accd331" data-linktype="relative-path">RPC</a></span>
server binding 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 the UUID specified in section <span><a href="e3c9c694-f896-46b9-9452-097f53e0c03f" data-linktype="relative-path">1.9</a></span> and endpoint
specified in section <span><a href="f6ef0bc1-f32e-45ef-bcfb-bcbd0d08c71d" data-linktype="relative-path">2.1</a></span>. A client can
create the binding handle using the rpc_string_binding_compose and
rpc_binding_from_string_binding APIs (as specified in [C706] the
&#34;rpc_string_binding_compose&#34; section) or equivalent on the client
system&#39;s implementation of RPC. When all operations using this handle are
completed, use the equivalent of rpc_binding_free to free the handle resources.</p><p><b>EntryNameSyntax: </b>An identifier that represents
the syntax used for the entry_name parameter. The value MUST be
RPC_C_NS_SYNTAX_DCE.</p><p><b>EntryName: </b>A Unicode <span><a href="https://go.microsoft.com/fwlink/?LinkId=90550" data-linktype="external">[UNICODE]</a></span>
string specifying the entry name of the name service entry, using the syntax
identified by the entry_name_syntax parameter, as specified in section <span><a href="99becf64-89ed-4bd8-adf0-470add859d15" data-linktype="relative-path">2.2.2</a></span>.</p><p><b>InqContext: </b>On successful completion, returns
a context handle for enumerating object UUID vectors by using the <span><a href="684ec84e-53cb-45a3-b5b9-ab0266d181b8" data-linktype="relative-path">I_nsi_entry_object_inq_next</a></span>
method. This context handle MUST be closed by using the <span><a href="9b992872-0677-4d58-9b14-780bccd6fad9" data-linktype="relative-path">I_nsi_entry_object_inq_done</a></span>
method.</p><p><b>status: </b>A 16-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 whole enumeration process.</p><p><b>Return Values: </b>This method does not return any
values. RPC exceptions can be thrown from this method.</p><p>Server Operations</p><p>The server MUST first validate that the <b>Entry Cache</b>
contains a server entry with an entry name equal to the value of the <i>EntryName</i>
parameter. If a server entry exists, the server MUST set the value of the <i>status</i>
parameter to 0 and create a new NSI_NS_HANDLE_T (section <span><a href="10af2082-cec8-46a7-85cd-54acca4eb805" data-linktype="relative-path">2.2.3.5</a></span>)
and return it to the caller in the <i>InqContext</i> parameter.</p><p>If the <b>Entry Cache</b> does not contain a server entry
with an entry name equal to the value of the <i>EntryName</i> parameter, the
server MUST set the value of the <i>status</i> parameter to
NSI_S_NO_MORE_BINDINGS (1). </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>