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。
如果函数失败,则返回值为以下错误代码之一。
值 | 含义 |
---|---|
|
调用客户端不拥有此目标。 |
|
该句柄无效。 |
注解
此函数还会锁定关联的路由。 避免长时间锁定目标,因为在释放锁定之前,任何其他客户端都无法访问目标和关联的路由。
客户端还可以在读取目标信息时使用此函数,同时防止在客户端的读取操作期间发生更改。 在这种情况下,请考虑改用 RtmGetDestInfo 。
有关使用此函数的示例代码,请参阅 使用 RtmUpdateAndUnlockRoute 就地更新路由。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | rtmv2.h |
Library | Rtm.lib |
DLL | Rtm.dll |