다음을 통해 공유

RpcMgmtEpEltInqBegin 함수(rpcdce.h)

  • 아티클

RpcMgmtEpEltInqBegin 함수는 엔드포인트 맵에서 요소를 보기 위한 조회 컨텍스트를 만듭니다.

구문

RPC_STATUS RpcMgmtEpEltInqBegin(
  RPC_BINDING_HANDLE EpBinding,
  unsigned long      InquiryType,
  RPC_IF_ID          *IfId,
  unsigned long      VersOption,
  UUID               *ObjectUuid,
  RPC_EP_INQ_HANDLE  *InquiryContext
);

매개 변수

EpBinding

엔드포인트 맵 요소를 볼 호스트에 대한 바인딩 핸들입니다. 로컬 호스트에서 요소를 보려면 NULL 을 지정합니다. 바인딩 핸들이 지정된 경우 바인딩 핸들의 개체 UUID는 NULL이어야 합니다. 있는 경우 바인딩 핸들의 엔드포인트가 무시되고 지정된 호스트의 엔드포인트 매퍼 데이터베이스에 대한 엔드포인트가 사용됩니다.

InquiryType

엔드포인트 맵에서 수행할 조회 유형을 나타내는 정수 값입니다. 유효한 조회 유형은 다음과 같습니다.

값 의미
RPC_C_EP_ALL_ELTS
 엔드포인트 맵의 모든 요소를 반환합니다. IfId, VersOption 및 ObjectUuid 매개 변수는 무시됩니다.
RPC_C_EP_MATCH_BY_IF
 엔드포인트 맵에서 IfId 및 VersOption 값으로 지정된 인터페이스 식별자를 포함하는 요소를 검색합니다.
RPC_C_EP_MATCH_BY_OBJ
 엔드포인트 맵에서 ObjectUuid로 지정된 개체 UUID를 포함하는 요소를 검색합니다.
RPC_C_EP_MATCH_BY_BOTH
 엔드포인트 맵에서 IfId, VersOption 및 ObjectUuid로 지정된 인터페이스 식별자 및 개체 UUID를 포함하는 요소를 검색합니다.

IfId

RpcMgmtEpEltInqNext에서 반환할 엔드포인트 맵 요소의 인터페이스 식별자입니다. 이 매개 변수는 InquiryType 이 RPC_C_EP_MATCH_BY_IF 또는 RPC_C_EP_MATCH_BY_BOTH 경우에만 사용됩니다. 그렇지 않은 경우 이 설정은 무시됩니다.

VersOption

RpcMgmtEpEltInqNext에서 IfId 매개 변수를 사용하는 방법을 지정합니다. 이 매개 변수는 InquiryType 이 RPC_C_EP_MATCH_BY_IF 또는 RPC_C_EP_MATCH_BY_BOTH 경우에만 사용됩니다. 그렇지 않은 경우 이 설정은 무시됩니다. 다음은 이 매개 변수에 유효한 값입니다.

값 의미
RPC_C_VERS_ALL
 버전 번호에 관계없이 지정된 인터페이스 UUID를 제공하는 엔드포인트 맵 요소를 반환합니다.
RPC_C_VERS_COMPATIBLE
 지정된 인터페이스 UUID의 주 버전과 지정된 인터페이스 UUID의 부 버전보다 크거나 같은 부 버전을 제공하는 엔드포인트 맵 요소를 반환합니다.
RPC_C_VERS_EXACT
 지정된 인터페이스 UUID의 지정된 버전을 제공하는 엔드포인트 맵 요소를 반환합니다.
RPC_C_VERS_MAJOR_ONLY
 지정된 인터페이스 UUID 의 동일한 주 버전을 제공하고 부 버전을 무시하는 엔드포인트 맵 요소를 반환합니다.
RPC_C_VERS_UPTO
 지정된 주 및 부 버전보다 작거나 같은 지정된 인터페이스 UUID 버전을 제공하는 엔드포인트 맵 요소를 반환합니다.

ObjectUuid

RpcMgmtEpEltInqNext가 엔드포인트 맵 요소에서 찾는 개체 UUID입니다. 이 매개 변수는 InquiryType 이 RPC_C_EP_MATCH_BY_OBJ 또는 RPC_C_EP_MATCH_BY_BOTH 경우에만 사용됩니다.

InquiryContext

RpcMgmtEpEltInqNext 및 RpcMgmtEpEltInqDone과 함께 사용할 조회 컨텍스트를 반환합니다. RPC_EP_INQ_HANDLE 참조하세요.

반환 값

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

설명

RpcMgmtEpEltInqBegin 함수는 엔드포인트 맵에 저장된 서버 주소 정보를 보기 위한 조회 컨텍스트를 만듭니다. Application은 InquiryType 및 VersOption을 사용하여 RpcMgmtEpEltInqNext 호출에서 반환할 다음 엔드포인트 맵 요소를 지정합니다.

  • 모든 요소
  • 지정된 인터페이스 식별자가 있는 요소
  • 지정된 개체 UUID를 가진 요소
  • 지정된 인터페이스 식별자와 개체 UUID가 모두 있는 요소
RpcMgmtEpEltInqNext를 호출하기 전에 애플리케이션은 먼저 이 함수를 호출하여 조회 컨텍스트를 만들어야 합니다. 엔드포인트 맵 요소를 본 후 애플리케이션은 RpcMgmtEpEltInqDone 을 호출하여 조회 컨텍스트를 삭제합니다.

요구 사항

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

추가 정보

RpcEpRegister

RpcMgmtEpEltInqDone

RpcMgmtEpEltInqNext