rtmGetOpaqueInformationPointer 函数 (rtmv2.h)

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

语法

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

参数

[in] RtmRegHandle

从对 RtmRegisterEntity 的上一次调用中获取的客户端的句柄。

[in] DestHandle

目标句柄。

[out] OpaqueInfoPointer

在输入时, OpaqueInfoPointer 是指向 NULL 的指针。

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

返回值

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

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

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

注解

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

要求

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

另请参阅

RtmLockDestination