nf-rpcnsi-rpcnsgroupmbrinqbeginw.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:rpcnsi.RpcNsGroupMbrInqBeginW	RpcNsGroupMbrInqBeginW function (rpcnsi.h)	The RpcNsGroupMbrInqBegin function creates an inquiry context for viewing group members. (Unicode)	RpcNsGroupMbrInqBegin RpcNsGroupMbrInqBegin function [RPC] RpcNsGroupMbrInqBeginW _rpc_rpcnsgroupmbrinqbegin rpc.rpcnsgroupmbrinqbegin rpcnsi/RpcNsGroupMbrInqBegin rpcnsi/RpcNsGroupMbrInqBeginW	rpc\rpcnsgroupmbrinqbegin.htm	Rpc	f3a98563-0c7f-4f4b-b272-af7c0366b95d	12/05/2018	RpcNsGroupMbrInqBegin, RpcNsGroupMbrInqBegin function [RPC], RpcNsGroupMbrInqBeginA, RpcNsGroupMbrInqBeginW, _rpc_rpcnsgroupmbrinqbegin, rpc.rpcnsgroupmbrinqbegin, rpcnsi/RpcNsGroupMbrInqBegin, rpcnsi/RpcNsGroupMbrInqBeginA, rpcnsi/RpcNsGroupMbrInqBeginW	rpcnsi.h	Rpc.h	Windows	Windows 2000 Professional [desktop apps only]	Windows 2000 Server [desktop apps only]				RpcNsGroupMbrInqBeginW (Unicode) and RpcNsGroupMbrInqBeginA (ANSI)						Rpcns4.lib	Rpcns4.dll		Windows			19H1	RpcNsGroupMbrInqBeginW rpcnsi/RpcNsGroupMbrInqBeginW	c++	APIRef kbSyntax	DllExport	Rpcns4.dll	RpcNsGroupMbrInqBegin RpcNsGroupMbrInqBeginA RpcNsGroupMbrInqBeginW

RpcNsGroupMbrInqBeginW function

-description

The RpcNsGroupMbrInqBegin function creates an inquiry context for viewing group members.

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

 

-parameters

-param GroupNameSyntax

Syntax of GroupName.

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.

-param GroupName

Pointer to the name of the RPC group to view.

-param MemberNameSyntax

Syntax of the return parameter, MemberName, in the RpcNsGroupMbrInqNext function.

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.

-param InquiryContext

Returns a pointer to a name-service handle for use with the RpcNsGroupMbrInqNext and RpcNsGroupMbrInqDone functions.

-returns

Value	Meaning
RPC_S_OK	The call succeeded.
RPC_S_INVALID_NAME_SYNTAX	The name syntax is invalid.
RPC_S_UNSUPPORTED_NAME_SYNTAX	The name syntax is not supported.
RPC_S_INCOMPLETE_NAME	The name is incomplete.
RPC_S_ENTRY_NOT_FOUND	The name-service entry was not found.
RPC_S_NAME_SERVICE_UNAVAILABLE	The name service is unavailable.

 

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

 

-remarks

The RpcNsGroupMbrInqBegin function creates an inquiry context for viewing the members of an RPC group. Before calling RpcNsGroupMbrInqNext, the application must first call RpcNsGroupMbrInqBegin to create an inquiry context. When finished viewing the RPC group members, the application calls RpcNsGroupMbrInqDone to delete the inquiry context.

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.

 

Note

The rpcnsi.h header defines RpcNsGroupMbrInqBegin as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

-see-also

RpcNsGroupMbrAdd

RpcNsGroupMbrInqDone

RpcNsGroupMbrInqNext