다음을 통해 공유

RpcMgmtEpEltInqNext 함수(rpcdce.h)

  • 아티클

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

구문

RPC_STATUS RpcMgmtEpEltInqNext(
  RPC_EP_INQ_HANDLE  InquiryContext,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE *Binding,
  RPC_CSTR           *Annotation
);

매개 변수

InquiryContext

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

IfId

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

Binding

선택 사항입니다. 엔드포인트 맵 요소의 바인딩 핸들을 반환합니다.

Annotation

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

반환 값

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

설명

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

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

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

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

요구 사항

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

추가 정보

RpcEpRegister

RpcMgmtEpEltInqBegin

RpcMgmtEpEltInqDone