Export (0) Print
Expand All
Expand Minimize

RpcNsGroupMbrInqNext function

The RpcNsGroupMbrInqNext function returns one entry name from a group at a time.

Note  This function is not supported on Windows Vista and later operating systems.

Syntax


RPC_STATUS RPC_ENTRY RpcNsGroupMbrInqNext(
  RPC_NS_HANDLE InquiryContext,
  unsigned char **MemberName
);

Parameters

InquiryContext

Name service handle.

MemberName

Returns the address of a pointer to an RPC group member name. The syntax of the returned name was specified by the MemberNameSyntax parameter in the RpcNsGroupMbrInqBegin function.

Specify a null value to prevent RpcNsGroupMbrInqNext from returning the MemberName parameter. In this case, the application does not call the RpcStringFree function.

Return value

ValueMeaning
RPC_S_OK

The call succeeded.

RPC_S_INVALID_NS_HANDLE

The name-service handle is invalid.

RPC_S_NO_MORE_MEMBERS

No more members.

RPC_S_NAME_SERVICE_UNAVAILABLE

The name service is unavailable.

 

Note  For a list of valid error codes, see RPC Return Values.

Remarks

The RpcNsGroupMbrInqNext function returns one member of the RPC group specified by the GroupName parameter in RpcNsGroupMbrInqBegin. An application can view all the members of an RPC group set by repeatedly calling RpcNsGroupMbrInqNext. When all the group members have been viewed, this function returns an RPC_S_NO_MORE_MEMBERS status code. The returned group members are unordered.

On each call to RpcNsGroupMbrInqNext that returns a member name, the RPC run-time library allocates memory for the returned MemberName. The application is responsible for calling RpcStringFree for each returned MemberName string. After viewing the RPC group's members, the application must call RpcNsGroupMbrInqDone to release the inquiry context.

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

Note  Windows 2000 Active Directory supports this function. Earlier versions of Windows NT support the use of this function with Cell Directory Service (CDS) only.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Rpcnsi.h (include Rpc.h)

Library

Rpcns4.lib

DLL

Rpcns4.dll

Unicode and ANSI names

RpcNsGroupMbrInqNextW (Unicode) and RpcNsGroupMbrInqNextA (ANSI)

See also

RpcNsGroupMbrInqBegin
RpcNsGroupMbrInqDone
RpcStringFree

 

 

Community Additions

ADD
Show:
© 2014 Microsoft