다음을 통해 공유

RpcMgmtEpEltInqNextW 함수(rpcdce.h)

  • 아티클

RpcMgmtEpEltInqNext 함수는 엔드포인트 맵에서 하나의 요소를 반환합니다.

통사론

RPC_STATUS RpcMgmtEpEltInqNextW(
  RPC_EP_INQ_HANDLE  InquiryContext,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE *Binding,
  UUID               *ObjectUuid,
  RPC_WSTR           *Annotation
);

매개 변수

InquiryContext

문의 컨텍스트를 지정합니다. 조회 컨텍스트는 RpcMgmtEpEltInqBegin반환됩니다.

IfId

엔드포인트 맵 요소의 인터페이스 식별자를 반환합니다.

Binding

선택적. 엔드포인트 맵 요소에서 바인딩 핸들을 반환합니다.

ObjectUuid

선택적. 엔드포인트 맵 요소에서 개체 UUID를 반환합니다.

Annotation

선택적. 엔드포인트 맵 요소에 대한 주석 문자열을 반환합니다. 엔드포인트 맵 요소에 주석 문자열이 없으면 빈 문자열("")이 반환됩니다.

반환 값

값 의미
RPC_S_OK
 호출이 성공했습니다.
 
참고 유효한 오류 코드 목록은 RPC 반환 값참조하세요.
 

발언

RpcMgmtEpEltInqNext 함수는 엔드포인트 맵에서 하나의 요소를 반환합니다. 선택한 요소는 문의 컨텍스트에 따라 달라집니다. 선택 조건은 InquiryContext반환한 RpcMgmtEpEltInqBegin 함수의 InquiryType 따라 결정됩니다.

애플리케이션은 RpcMgmtEpEltInqNext반복적으로 호출하여 선택한 모든 엔드포인트 맵 요소를 볼 수 있습니다. 모든 요소를 볼 때 이 함수는 RPC_X_NO_MORE_ENTRIES 상태를 반환합니다. 반환된 요소는 순서가 지정되지 않습니다.

각 인수가 NULL이 아닌 경우 RPC 런타임 함수 라이브러리는 이 함수에 대한 각 호출에서 Binding 및 주석 메모리를 할당합니다. 애플리케이션은 반환된 각 바인딩 대해 RpcBindingFree 호출하고 반환된 각 주석대해 RpcStringFree 담당합니다.

엔드포인트 맵 요소를 본 후 애플리케이션은 RpcMgmtEpEltInqDone 호출하여 조회 컨텍스트를 삭제해야 합니다.

메모

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

요구 사항

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

참고 항목

RpcEpRegister

RpcMgmtEpEltInqBegin

RpcMgmtEpEltInqDone