IRpcOptions::Query 메서드(objidl.h)

RPC 바인딩 옵션 속성의 값을 검색합니다.

구문

HRESULT Query(
  [in]  IUnknown          *pPrx,
  [in]  RPCOPT_PROPERTIES dwProperty,
  [out] ULONG_PTR         *pdwValue
);

[in] pPrx

속성을 쿼리하는 프록시에 대한 포인터입니다.

[in] dwProperty

쿼리할 속성의 식별자이며, COMBND_RPCTIMEOUT 또는 COMBND_SERVER_LOCALITY 있어야 합니다(이 플래그는 Windows Server 2003부터 사용할 수 있음).

[out] pdwValue

속성 값에 대한 포인터입니다.

이 메서드는 표준 반환 값 E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL 및 S_OK 반환할 수 있습니다.

Set 메서드를 사용하여 COMBND_RPCTIMEOUT 속성을 설정할 수도 있지만 COMBND_SERVER_LOCALITY 속성만 쿼리할 수 있습니다.

COMBND_RPCTIMEOUT 속성의 가능한 값에 대한 테이블은 IRpcOptions 를 참조하세요.

RPC 연결의 원격 정도를 설명하는 COMBND_SERVER_LOCALITY 속성의 가능한 값은 다음 표에 열거되어 있습니다.

값	Description
SERVER_LOCALITY_PROCESS_LOCAL	해당 항목은 클라이언트와 동일한 프로세스에 있습니다.
SERVER_LOCALITY_MACHINE_LOCAL	해당 클라이언트와 동일한 컴퓨터에 있지만 다른 프로세스에 있습니다.
SERVER_LOCALITY_REMOTE	해당 항목은 원격 컴퓨터에 있습니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	objidl.h(ObjIdl.h 포함)