changeNtmsMediaType 函数 (ntmsapi.h)

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

ChangeNtmsMediaType 函数将指定的 PMID 移动到指定的目标媒体池，并将 PMID 的媒体类型标识符设置为目标媒体池的媒体类型。

语法

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

[in] hSession

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

[in] lpMediaId

要移动的物理介质的唯一标识符。

[in] lpPoolId

要从中分配媒体的媒体池的唯一标识符。

此函数返回以下值之一。

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

ChangeNtmsMediaType 函数使用与 MoveToNtmsMediaPool 函数相同的策略来移动媒体， (无法识别的媒体只能移动到可用池) 。