<div class="content" name="I_nsi_entry_object_inq_begin" uuid="49bdfea1-93c0-449f-94a4-aef47e7b3a95"><p>The I_nsi_entry_object_inq_begin method is invoked to
enumerate the <a href="55ec267c-87d9-4d97-a9d5-5681f5f283b8#gt_0a38e28d-7525-4d2d-8c62-43aedaf47b74" data-linktype="relative-path">object UUIDs</a>
on a <a href="55ec267c-87d9-4d97-a9d5-5681f5f283b8#gt_6cfe4abe-94bd-43b6-b666-3618d9093373" data-linktype="relative-path">name service entry</a>.
The <a href="55ec267c-87d9-4d97-a9d5-5681f5f283b8#gt_9c5903c1-1477-4181-b451-3ba1e34a0c0c" data-linktype="relative-path">MIDL</a> 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 <a href="55ec267c-87d9-4d97-a9d5-5681f5f283b8#gt_8a7f6700-8311-45bc-af10-82e10accd331" data-linktype="relative-path">RPC</a> server binding handle,
as specified in <a href="https://go.microsoft.com/fwlink/?LinkId=89824" data-linktype="external">[C706]</a>
Part 2, &#34;Binding Handle&#34;. A client creates this handle by binding to
the locator server using the UUID specified in section <a href="e3c9c694-f896-46b9-9452-097f53e0c03f" data-linktype="relative-path">1.9</a> and endpoint specified
in section <a href="f6ef0bc1-f32e-45ef-bcfb-bcbd0d08c71d" data-linktype="relative-path">2.1</a>. 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 <a href="https://go.microsoft.com/fwlink/?LinkId=90550" data-linktype="external">[UNICODE]</a> string
specifying the entry name of the name service entry, using the syntax
identified by the entry_name_syntax parameter, as specified in section <a href="99becf64-89ed-4bd8-adf0-470add859d15" data-linktype="relative-path">2.2.2</a>.</p><p><b>InqContext: </b>On successful completion, returns
a context handle for enumerating object UUID vectors by using the <a href="684ec84e-53cb-45a3-b5b9-ab0266d181b8" data-linktype="relative-path">I_nsi_entry_object_inq_next</a>
method. This context handle MUST be closed by using the <a href="9b992872-0677-4d58-9b14-780bccd6fad9" data-linktype="relative-path">I_nsi_entry_object_inq_done</a>
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 <a href="10af2082-cec8-46a7-85cd-54acca4eb805" data-linktype="relative-path">2.2.3.5</a>) 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 <a href="../ms-rpce/290c38b1-92fe-4229-91e6-4fc376610c15" data-linktype="relative-path">[MS-RPCE]</a>.</p></div>