RpcNsEntryObjectInqBegin function
The RpcNsEntryObjectInqBegin function creates an inquiry context for the objects of a name-service database entry.
Syntax
RPC_STATUS RPC_ENTRY RpcNsEntryObjectInqBegin( unsigned long EntryNameSyntax, unsigned char *EntryName, RPC_NS_HANDLE *InquiryContext );
Parameters
- EntryNameSyntax
-
Syntax to use in EntryName.
To use the syntax specified in the registry value entry HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, provide a value of RPC_C_NS_SYNTAX_DEFAULT.
- EntryName
-
Pointer 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 functions.
Return value
| Value | Meaning |
|---|---|
|
The call succeeded. |
|
The name syntax is invalid. |
|
The name syntax is unsupported. |
|
The name is incomplete. |
|
The name-service entry was not found. |
|
The name service is unavailable. |
Remarks
The RpcNsEntryObjectInqBegin function creates an inquiry context for viewing the object UUIDs exported to EntryName.
Before calling the RpcNsEntryObjectInqNext function, the application must first call RpcNsEntryObjectInqBegin to create an inquiry context.
When finished viewing the object UUIDs, the application calls the RpcNsEntryObjectInqDone function to delete the inquiry context.
Requirements
|
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows 2000 Server [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
|
Unicode and ANSI names |
RpcNsEntryObjectInqBeginW (Unicode) and RpcNsEntryObjectInqBeginA (ANSI) |
See also