RpcNsEntryObjectInqNext

The RpcNsEntryObjectInqNext function returns one object at a time from a name-service database entry.

#include <rpc.h>
RPC_STATUS RPC_ENTRY RpcNsEntryObjectInqNext( 
  RPC_NS_HANDLE  InquiryContext,   
  UUID *  ObjUuid                  
);
 

Parameters

InquiryContext
Specifies a name-service handle that indicates the object UUIDs for a name-service database entry.
ObjUuid
Returns a pointer to an exported object UUID.

Return Values

Value Meaning
RPC_S_OK Success
RPC_S_NO_MORE_MEMBERS No more members
RPC_S_INCOMPLETE_NAME Incomplete name
RPC_S_ENTRY_NOT_FOUND Name-service entry not found
RPC_S_NAME_SERVICE_UNAVAILABLE Name-service unavailable

Remarks

The RpcNsEntryObjectInqNext routine returns one of the object UUIDs exported to the name-service database entry specified by the EntryName argument in the RpcNsEntryObjectInqBegin routine.

An application can view all of the exported object UUIDs by repeatedly calling the RpcNsEntryObjectInqNext routine. When all the object UUIDs have been viewed, this routine returns an RPC_S_NO_MORE_MEMBERS status code. The returned object UUIDs are unordered.

The application supplies the memory for the object UUID returned in the ObjUuid argument.

After viewing the object UUIDs, the application must call the RpcNsEntryObjectInqDone routine to release the inquiry context.

The order in which object UUIDs are returned can be different for each viewing of an entry. This means that the order in which object UUIDs are returned to an application can be different each time the application is run.

QuickInfo

  Windows NT: Yes
  Windows CE: Unsupported.
  Header: Declared in rpcnsi.h.
  Import Library: Link with rpcns4.lib.

See Also

RpcNsBindingExport, RpcNsEntryObjectInqBegin, RpcNsEntryObjectInqDone