rtmGetEntityMethods 函数 (rtmv2.h)

  • 项目

RtmGetEntityMethods 函数查询指定的客户端，以确定哪些方法可供另一个客户端调用。

语法

DWORD RtmGetEntityMethods(
  [in]      RTM_ENTITY_HANDLE         RtmRegHandle,
  [in]      RTM_ENTITY_HANDLE         EntityHandle,
  [in, out] PUINT                     NumMethods,
  [out]     PRTM_ENTITY_EXPORT_METHOD ExptMethods
);

参数

[in] RtmRegHandle

从先前调用 RtmRegisterEntity 获取的客户端的句柄。

[in] EntityHandle

要为其获取方法的客户端的句柄。

[in, out] NumMethods

输入时， NumMethods 指定指向 UINT 值的有效指针。 指定零可返回可导出的方法数。

输出时， NumMethods 接收客户端导出的方法数。

[out] ExptMethods

接收指向 RTM_ENTITY_EXPORT_METHOD 结构的指针，该结构包含调用客户端请求的方法标识符集。

返回值

如果函数成功，则返回值NO_ERROR。

如果函数失败，则返回值为以下错误代码之一。

值 含义
ERROR_INSUFFICIENT_BUFFER
 提供的缓冲区不够大，无法容纳所有请求的信息。

注解

不要直接调用其他客户端的 方法，请始终使用 RtmInvokeMethod。 使用 RtmInvokeMethod 时，路由表管理器会执行错误检查，以确保客户端未注销或已注销。

如果返回ERROR_INSUFFICIENT_BUFFER， 则 ExptMethods 中可能存在一些数据; NumMethods 指定缓冲区中实际容纳的方法数。

如果不再需要实体句柄，请通过调用 RtmReleaseEntities 将其释放。

有关使用此函数的示例代码，请参阅 获取和调用客户端的导出方法。

要求

要求 值
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 rtmv2.h
Library Rtm.lib
DLL Rtm.dll

另请参阅

RtmBlockMethods

RtmInvokeMethod