3.1.4.6 I_nsi_entry_object_inq_next (Opnum 3)

  • Article

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.

uuid_vec: On successful completion, returns a vector of object UUIDs for the name service entry. The caller of this method is responsible for freeing any memory allocated for this parameter.

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.

Server Operations

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.

Exceptions Thrown

No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified in [MS-RPCE].