rtmGetOpaqueInformationPointer 函数 (rtmv2.h)

  • 项目

RtmGetOpaqueInformationPointer 函数返回指向为此客户端保留的目标中不透明信息字段的指针。 指针使客户端能够将特定于客户端的信息与路由表中的目标一起存储。

语法

DWORD RtmGetOpaqueInformationPointer(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_DEST_HANDLE   DestHandle,
  [out] PVOID             *OpaqueInfoPointer
);

parameters

[in] RtmRegHandle

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

[in] DestHandle

目标的句柄。

[out] OpaqueInfoPointer

输入时， OpaqueInfoPointer 是指向 NULL 的指针。

输出时， OpaqueInfoPointer 接收指向不透明信息指针的指针。 如果客户端在注册期间未保留不透明指针，则此参数保持不变。

返回值

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

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

值 含义
ERROR_INVALID_HANDLE
 该句柄无效。
ERROR_NOT_FOUND
 客户端未保留不透明指针。
 
 

注解

有关使用此函数的示例代码，请参阅 访问目标中的不透明指针。

要求

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

请参阅

RtmLockDestination