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
);
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 |
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.
Windows NT: Yes
Windows CE: Unsupported.
Header: Declared in rpcnsi.h.
Import Library: Link with rpcns4.lib.
RpcNsBindingExport, RpcNsEntryObjectInqBegin, RpcNsEntryObjectInqDone