RpcNsGroupMbrInqNextA 함수(rpcnsi.h)

RpcNsGroupMbrInqNext 함수는 그룹에서 한 번에 하나의 항목 이름을 반환합니다.

참고 이 함수는 Windows Vista 이상 운영 체제에서 지원되지 않습니다.

 

구문

RPC_STATUS RpcNsGroupMbrInqNextA(
  RPC_NS_HANDLE InquiryContext,
  RPC_CSTR      *MemberName
);

매개 변수

InquiryContext

이름 서비스 핸들입니다.

MemberName

RPC 그룹 멤버 이름에 대한 포인터의 주소를 반환합니다. 반환된 이름의 구문은 RpcNsGroupMbrInqBegin 함수의 MemberNameSyntax 매개 변수에 의해 지정되었습니다.

RpcNsGroupMbrInqNext가MemberName 매개 변수를 반환하지 못하도록 null 값을 지정합니다. 이 경우 애플리케이션은 RpcStringFree 함수를 호출하지 않습니다.

반환 값

값	의미
RPC_S_OK	호출이 성공했습니다.
RPC_S_INVALID_NS_HANDLE	이름 서비스 핸들이 잘못되었습니다.
RPC_S_NO_MORE_MEMBERS	더 이상 멤버가 없습니다.
RPC_S_NAME_SERVICE_UNAVAILABLE	이름 서비스를 사용할 수 없습니다.

 

참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.

 

설명

RpcNsGroupMbrInqNext 함수는 RpcNsGroupMbrInqBegin의 GroupName 매개 변수로 지정된 RPC 그룹의 한 멤버를 반환합니다. 애플리케이션은 RpcNsGroupMbrInqNext를 반복적으로 호출하여 RPC 그룹 집합의 모든 멤버를 볼 수 있습니다. 모든 그룹 멤버가 표시되면 이 함수는 RPC_S_NO_MORE_MEMBERS 상태 코드를 반환합니다. 반환된 그룹 멤버의 순서가 지정되지 않습니다.

멤버 이름을 반환하는 RpcNsGroupMbrInqNext에 대한 각 호출에서 RPC 런타임 라이브러리는 반환된 MemberName에 대한 메모리를 할당합니다. 애플리케이션은 반환된 각 MemberName 문자열에 대해 RpcStringFree를 호출합니다. RPC 그룹의 멤버를 본 후 애플리케이션은 RpcNsGroupMbrInqDone 을 호출하여 문의 컨텍스트를 해제해야 합니다.

그룹 멤버가 반환되는 순서는 그룹 보기마다 다를 수 있습니다. 즉, 애플리케이션을 실행할 때마다 그룹 멤버가 애플리케이션에 반환되는 순서가 다를 수 있습니다.

참고 Windows 2000 Active Directory는 이 함수를 지원합니다. 이전 버전의 Windows NT는 CDS(셀 디렉터리 서비스)에서만 이 함수를 사용할 수 있습니다.

 

참고

rpcnsi.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 RpcNsGroupMbrInqNext를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	rpcnsi.h(Rpc.h 포함)
라이브러리	Rpcns4.lib
DLL	Rpcns4.dll

추가 정보

RpcNsGroupMbrInqBegin

RpcNsGroupMbrInqDone

RpcStringFree