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)

另请参阅

IRpcOptions