deleteNtmsMediaPool 函数 (ntmsapi.h)

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

DeleteNtmsMediaPool 函数删除指定的应用程序媒体池。

语法

DWORD DeleteNtmsMediaPool(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpPoolId
);

[in] hSession

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

[in] lpPoolId

媒体池的唯一标识符。

此函数返回以下值之一。

值	含义
ERROR_ACCESS_DENIED	拒绝NTMS_MODIFY_ACCESS媒体池。其他安全错误也可能存在，但它们指示安全子系统错误。 Windowsxp：拒绝NTMS_CONTROL_ACCESS媒体池。其他安全错误也可能存在，但它们指示安全子系统错误。
ERROR_DATABASE_FAILURE	数据库不可访问或已损坏。
ERROR_INVALID_HANDLE	会话句柄缺失或无效。
ERROR_INVALID_MEDIA_POOL	无法打开现有媒体池，或尝试删除可用、导入或无法识别的媒体池。
ERROR_INVALID_PARAMETER	缺少媒体池 ID。
ERROR_NOT_EMPTY	媒体池必须为空才能删除。
ERROR_NOT_ENOUGH_MEMORY	处理期间发生分配失败。
ERROR_SUCCESS	函数成功。

使用 DeleteNtmsMediaPool 函数只能删除空的媒体池。

免费、无法识别和导入的媒体池由 RSM 管理，无法使用 DeleteNtmsMediaPool 删除。