RpcNsGroupMbrInqBegin
The RpcNsGroupMbrInqBegin
function creates an inquiry context for viewing group members.
#include <rpc.h>
RPC_STATUS RPC_ENTRY RpcNsGroupMbrInqBegin(
|
unsigned long GroupNameSyntax, |
|
|
unsigned char * GroupName, |
|
|
unsigned long MemberNameSyntax, |
|
|
RPC_NS_HANDLE * InquiryContext |
|
|
); |
|
Parameters
GroupNameSyntax
Specifies an
integer value that indicates the syntax of the next argument, GroupName.
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.
GroupName
Points to the
name of the RPC group to view.
MemberNameSyntax
Specifies an
integer value that indicates the syntax of the return argument, MemberName,
in the RpcNsGroupMbrInqNext routine.
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.
InquiryContext
Returns a
pointer to a name-service handle for use with the RpcNsGroupMbrInqNext
and RpcNsGroupMbrInqDone routines.
Remarks
Note This DCE
function is not supported by the Microsoft Locator.
The RpcNsGroupMbrInqBegin
routine creates an inquiry context for viewing the members of an RPC group.
Before
calling the RpcNsGroupMbrInqNext routine, the application must first
call RpcNsGroupMbrInqBegin to create an inquiry context.
When finished
viewing the RPC group members, the application calls the RpcNsGroupMbrInqDone
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