RpcNsEntryObjectInqBegin
The RpcNsEntryObjectInqBegin
function creates an inquiry context for a name-service database entry s
objects.
#include <rpc.h>
RPC_STATUS RPC_ENTRY RpcNsEntryObjectInqBegin(
|
unsigned long EntryNameSyntax, |
|
|
unsigned char * EntryName, |
|
|
RPC_NS_HANDLE * InquiryContext |
|
|
); |
|
Parameters
EntryNameSyntax
Specifies an
integer value that indicates the syntax to use in the next argument, EntryName.
To use the
syntax specified in the registry value
HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\
DefaultSyntax, provide a value of RPC_C_NS_SYNTAX_DEFAULT.
EntryName
Points to the
name-service database entry name for which object UUIDs are to be viewed.
InquiryContext
Returns a
pointer to a name-service handle for use with the RpcNsEntryObjectInqNext
and RpcNsEntryObjectInqDone routines.
Remarks
The RpcNsEntryObjectInqBegin
routine creates an inquiry context for viewing the object UUIDs exported to EntryName.
Before
calling the RpcNsEntryObjectInqNext routine, the application must first
call RpcNsEntryObjectInqBegin to create an inquiry context.
When finished
viewing the object UUIDs, the application calls the RpcNsEntryObjectInqDone
routine to delete the inquiry context.
Return Values
|
Value |
Meaning |
|
RPC_S_OK |
Success |
|
RPC_S_INVALID_NAME_SYNTAX |
Invalid name
syntax |
|
RPC_S_UNSUPPORTED_NAME_SYNTAX |
Unsupported
name syntax |
|
RPC_S_INCOMPLETE_NAME |
Incomplete
name |
|
RPC_S_ENTRY_NOT_FOUND |
Name-service
entry not found |
|
RPC_S_NAME_SERVICE_UNAVAILABLE |
Name
service unavailable |
See Also