DeallocateNtmsMedia 函数 (ntmsapi.h)

[从 Windows 7 和 Windows Server 2008 R2 起，可移动存储管理器不再可用。]

DeallocateNtmsMedia 函数解除分配与指定逻辑媒体关联的端。

语法

DWORD DeallocateNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId,
       DWORD       dwOptions
);

[in] hSession

OpenNtmsSession 函数返回的会话的句柄。

[in] lpMediaId

逻辑媒体的唯一标识符 (LMID) 。

dwOptions

保留;必须为零。

此函数返回以下值之一。

值	含义
ERROR_ACCESS_DENIED	拒绝NTMS_CONTROL_ACCESS媒体的媒体池。其他安全错误也可能存在，但它们表示存在安全子系统错误。 Windowsxp：拒绝NTMS_MODIFY_ACCESS媒体的媒体池。其他安全错误也可能存在，但它们表示存在安全子系统错误。
ERROR_DATABASE_FAILURE	数据库不可访问或已损坏。
ERROR_DATABASE_FULL	数据库已满。
ERROR_INVALID_HANDLE	会话句柄缺失或无效。
ERROR_INVALID_MEDIA	LMID 无效。
ERROR_INVALID_PARAMETER	缺少媒体或媒体池 ID。
ERROR_INVALID_PARTITION	LMID 端无效。
ERROR_NOT_ENOUGH_MEMORY	处理期间发生分配失败。
ERROR_SUCCESS	函数成功。

使用 DeallocateNtmsMedia 函数解除分配逻辑介质时，RSM 会将与逻辑媒体关联的一侧置于“可用”或“已解除授权”媒体状态。解除分配逻辑媒体后，将从系统中删除逻辑媒体。

如果已为该端分配了媒体池中指定的最大次数，则双方在解除分配时将解除授权。媒体处于“已停用”状态后，无法再次分配媒体。

Windows Server 2003： 如果将媒体返回到可用池，NTMS_USE_ACCESS到可用池，并且需要NTMS_CONTROL_ACCESS源池。如果可用池不是目标媒体池，则源池和目标池都需要NTMS_CONTROL_ACCESS。