DeleteNtmsMediaType 函数 (ntmsapi.h)

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

DeleteNtmsMediaType 函数从指定的库中删除指定的媒体类型关系，前提是该库不包含指定媒体类型的任何物理媒体对象。

语法

DWORD DeleteNtmsMediaType(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaTypeId,
  [in] LPNTMS_GUID lpLibId
);

[in] hSession

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

[in] lpMediaTypeId

要从库中删除的媒体类型的唯一标识符。

[in] lpLibId

要从中删除媒体类型的库的唯一标识符。

此函数返回以下值之一。

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

如果 RSM 系统中没有指定媒体类型的物理媒体对象，并且 RSM 系统中没有包含指定媒体类型关系的库对象，则将删除该媒体类型的系统媒体池。无法删除系统媒体池不会导致 DeleteNtmsMediaType 函数失败。