22.214.171.124 I_nsi_entry_object_inq_next (Opnum 3)
The I_nsi_entry_object_inq_next method is invoked to continue an enumeration initiated by a previous call to the I_nsi_entry_object_inq_begin method. The MIDL syntax of the method is specified as follows.
void I_nsi_entry_object_inq_next( [in] handle_t hrpcPrimaryLocatorHndl, [in] NSI_NS_HANDLE_T InqContext, [out] NSI_UUID_VECTOR_P_T* uuid_vec, [out] unsigned short* status );
hrpcPrimaryLocatorHndl: An RPC server binding handle, as specified in [C706] Part 2, "Binding Handle". A client creates this handle by binding to the locator server using the UUID specified in section 1.9 and endpoint specified in section 2.1. 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 "rpc_string_binding_compose" section) or equivalent on the client system's implementation of RPC. When all operations using this handle are completed, use the equivalent of rpc_binding_free to free the handle resources.
InqContext: A context handle returned by the server from a preceding call to the I_nsi_entry_object_inq_begin method.
status: 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 continuation of the enumeration process.
Return Values: This method does not return any values. RPC exceptions can be thrown from this method.
The server MUST set the value of status to 0 (NSI_S_OK) and set the value of uuid_vec to a vector of object UUIDs for the name service entry specified by the InqContext parameter.
For a failed operation, if the name service entry specified by the InqContext parameter has no object UUIDs, the server MUST set the value of status to NSI_S_OK and set the value of uuid_vec to NULL.
No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified in [MS-RPCE].