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 属性的可能值。
值 | 说明 |
---|---|
SERVER_LOCALITY_PROCESS_LOCAL | 对应项与客户端位于同一进程中。 |
SERVER_LOCALITY_MACHINE_LOCAL | 相对应的计算机与客户端位于同一台计算机上,但位于不同的进程中。 |
SERVER_LOCALITY_REMOTE | 对应项位于远程计算机上。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | objidl.h (包括 ObjIdl.h) |