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
엔드포인트 맵에서 수행할 조회 유형을 나타내는 정수 값입니다. 유효한 조회 유형은 다음과 같습니다.
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 경우에만 사용됩니다. 그렇지 않은 경우 이 설정은 무시됩니다. 다음은 이 매개 변수에 유효한 값입니다.
| 값 | 의미 |
|---|---|
|
버전 번호에 관계없이 지정된 인터페이스 UUID를 제공하는 엔드포인트 맵 요소를 반환합니다. |
|
지정된 인터페이스 UUID의 주 버전과 지정된 인터페이스 UUID의 부 버전보다 크거나 같은 부 버전을 제공하는 엔드포인트 맵 요소를 반환합니다. |
|
지정된 인터페이스 UUID의 지정된 버전을 제공하는 엔드포인트 맵 요소를 반환합니다. |
|
지정된 인터페이스 UUID 의 동일한 주 버전을 제공하고 부 버전을 무시하는 엔드포인트 맵 요소를 반환합니다. |
|
지정된 주 및 부 버전보다 작거나 같은 지정된 인터페이스 UUID 버전을 제공하는 엔드포인트 맵 요소를 반환합니다. |
ObjectUuid
RpcMgmtEpEltInqNext가 엔드포인트 맵 요소에서 찾는 개체 UUID입니다. 이 매개 변수는 InquiryType 이 RPC_C_EP_MATCH_BY_OBJ 또는 RPC_C_EP_MATCH_BY_BOTH 경우에만 사용됩니다.
InquiryContext
RpcMgmtEpEltInqNext 및 RpcMgmtEpEltInqDone과 함께 사용할 조회 컨텍스트를 반환합니다. RPC_EP_INQ_HANDLE 참조하세요.
반환 값
| 값 | 의미 |
|---|---|
|
호출이 성공했습니다. |
설명
RpcMgmtEpEltInqBegin 함수는 엔드포인트 맵에 저장된 서버 주소 정보를 보기 위한 조회 컨텍스트를 만듭니다. Application은 InquiryType 및 VersOption을 사용하여 RpcMgmtEpEltInqNext 호출에서 반환할 다음 엔드포인트 맵 요소를 지정합니다.
- 모든 요소
- 지정된 인터페이스 식별자가 있는 요소
- 지정된 개체 UUID를 가진 요소
- 지정된 인터페이스 식별자와 개체 UUID가 모두 있는 요소
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | rpcdce.h(Rpc.h 포함) |
| 라이브러리 | Rpcrt4.lib |
| DLL | Rpcrt4.dll |