IRpcOptions::Query 方法 (objidl.h)
擷取 RPC 系結選項屬性的值。
語法
HRESULT Query(
[in] IUnknown *pPrx,
[in] RPCOPT_PROPERTIES dwProperty,
[out] ULONG_PTR *pdwValue
);
參數
[in] pPrx
正在查詢其屬性之 Proxy 的指標。
[in] dwProperty
從 Windows Server 2003.) 開始,必須COMBND_RPCTIMEOUT或COMBND_SERVER_LOCALITY (此旗标的属性标识符
[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 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | objidl.h (包含 ObjIdl.h) |