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	媒體集區標識碼無效。
ERROR_INVALID_PARAMETER	媒體集區或媒體標識碼遺失。
ERROR_NOT_ENOUGH_MEMORY	處理期間發生配置失敗。
ERROR_SUCCESS	函式成功。

ChangeNtmsMediaType 函式使用與MoveToNtmsMediaPool函式相同的原則， (無法辨識的媒體只能移至免費集區) 。