rtmLockDestination 函数 (rtmv2.h)

  • 项目

RtmLockDestination 函数锁定或解锁路由表中的目标。 使用此函数在更改不透明指针时保护目标。

语法

DWORD RtmLockDestination(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] RTM_DEST_HANDLE   DestHandle,
  [in] BOOL              Exclusive,
  [in] BOOL              LockDest
);

参数

[in] RtmRegHandle

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

[in] DestHandle

要锁定的目标的句柄。

[in] Exclusive

指定是在独占 (TRUE) 还是共享 (FALSE) 模式下锁定或解锁目标。

[in] LockDest

指定是锁定还是解锁目标。 指定 TRUE 可锁定目标;指定 FALSE 以解锁它。

返回值

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

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

值 含义
ERROR_ACCESS_DENIED
 调用客户端不拥有此目标。
ERROR_INVALID_HANDLE
 该句柄无效。
 
 

注解

此函数还会锁定关联的路由。 避免长时间锁定目标，因为在释放锁定之前，任何其他客户端都无法访问目标和关联的路由。

客户端还可以在读取目标信息时使用此函数，同时防止在客户端的读取操作期间发生更改。 在这种情况下，请考虑改用 RtmGetDestInfo 。

有关使用此函数的示例代码，请参阅 使用 RtmUpdateAndUnlockRoute 就地更新路由。

要求

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

另请参阅

RtmGetOpaqueInformationPointer