<div class="content" name="I_nsi_lookup_next" uuid="8e23ebb6-155b-48e1-9315-57fe113d095a"><p>The I_nsi_lookup_next method is invoked to continue an
enumeration of <a href="55ec267c-87d9-4d97-a9d5-5681f5f283b8#gt_1cf35308-abab-4123-9cbd-99c42dc9a6ff" data-linktype="relative-path">binding</a>
vectors that satisfy the criteria specified in a call to the <a href="3674c5af-b5d5-4365-8f19-9db8f64b4189" data-linktype="relative-path">I_nsi_lookup_begin</a> method.
The number of bindings in the binding_vector is limited by the parameter
binding_max_count specified in the call to the I_nsi_lookup_begin method. The <a href="55ec267c-87d9-4d97-a9d5-5681f5f283b8#gt_9c5903c1-1477-4181-b451-3ba1e34a0c0c" data-linktype="relative-path">MIDL</a> syntax of this method
is specified as follows.</p><dl>
<dd>
<div><pre> void I_nsi_lookup_next(
   [in] handle_t hrpcPrimaryLocatorHndl,
   [in] NSI_NS_HANDLE_T import_context,
   [out] NSI_BINDING_VECTOR_P_T* binding_vector,
   [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
systems&#39; 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>import_context: </b>A context handle returned by a
preceding call to the I_nsi_lookup_begin method.</p><p><b>binding_vector: </b>On successful completion, returns
a vector containing bindings that satisfy the criteria defined in the preceding
call to the I_nsi_lookup_begin method. The caller MUST not assume that the
bindings are ordered. The client is responsible for freeing the memory
allocated for the <b>binding_vector</b>. The memory allocated for the <b>binding_vector</b>
does not need to be freed before subsequent calls to I_nsi_lookup_next.</p><p><b>status: </b>A 16-bit value that indicates the
result of the method call. Any other values, except those listed as follows,
MUST be treated as failures and MUST be treated identically. Failure is
typically a serious condition (e.g., host out of memory) and SHOULD abort the
current operation and then propagated to the higher-layer caller. In the event
of failure, the caller SHOULD invoke <a href="f6d8c155-3ef4-4c22-b43d-68fe0e375bcf" data-linktype="relative-path">I_nsi_lookup_done</a>
immediately, although it might fail as well. </p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>NSI_S_OK 0x00000000</td>
  <td>The call returned successfully and binding vector contains at least one binding. There can be additional bindings that satisfy the criteria.</td>
 </tr><tr>
  <td>NSI_S_NO_MORE_BINDINGS 0x00000001</td>
  <td>There are no more bindings that satisfy the criteria and binding vector contains no bindings.</td>
 </tr></tbody></table>
</dd></dl><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 <a href="../ms-rpce/290c38b1-92fe-4229-91e6-4fc376610c15" data-linktype="relative-path">[MS-RPCE]</a>.</p></div>