共用方式為

MoveToNtmsMediaPool 函式 (ntmsapi.h)

  • 發行項

[從 Windows 7 和 Windows Server 2008 R2 起，已不再提供卸除式儲存管理員 。]

MoveToNtmsMediaPool 函式會將指定的媒體從其目前的媒體集區移至指定的媒體集區。

語法

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

參數

[in] hSession

OpenNtmsSession 函式所傳回之會話的句柄。

[in] lpMediaId

實體媒體片段的唯一標識符。

[in] lpPoolId

目的地媒體集區的唯一標識碼。

傳回值

此函式會傳回下列其中一個值。

值 意義
ERROR_ACCESS_DENIED
 NTMS_CONTROL_ACCESS媒體的媒體集區遭到拒絕。 其他安全性錯誤也是可行的，但它們會指出安全性子系統錯誤。

Windowsxp： NTMS_MODIFY_ACCESS來源媒體的媒體集區或目的地媒體集區遭到拒絕。 其他安全性錯誤也是可行的，但它們會指出安全性子系統錯誤。
ERROR_BUSY
 媒體至少有一端正在使用中，或目前無法使用。
ERROR_DATABASE_FAILURE
 資料庫無法存取或損毀。
ERROR_DATABASE_FULL
 資料庫已滿。
ERROR_INVALID_HANDLE
 會話句柄遺失或無效。
ERROR_INVALID_MEDIA_POOL
 目的地媒體集區無效;媒體集區不存在;或無法辨識或匯入集區中的媒體只能移至免費集區。
ERROR_INVALID_MEDIA
 來源媒體或隱含的來源媒體集區無效。
ERROR_INVALID_PARAMETER
 缺少媒體標識碼或媒體集區標識碼。
ERROR_MEDIA_INCOMPATIBLE
 來源的媒體類型與目的地媒體集區的媒體類型不同。
ERROR_NOT_ENOUGH_MEMORY
 處理期間發生配置失敗。
ERROR_SUCCESS
 函式成功。

備註

MoveToNtmsMediaPool 函式中指定的目的地集區必須具有相同的媒體類型，且具有相容的安全性。

RSM 會將媒體上的標識碼寫入媒體，再將媒體移至免費的媒體集區。

具有 [已完成]、[已配置] 或 [保留] 狀態之分割區的媒體可能不會移至 [免費媒體集區]。 只有當媒體的所有分割區都處於匯入狀態時，媒體才能移至匯入集區。

Windows Server 2003： 如果免費集區是來源集區，NTMS_USE_ACCESS至免費集區，而且需要NTMS_CONTROL_ACCESS目的地集區。 否則，來源和目的地集區都需要NTMS_CONTROL_ACCESS。 如果免費集區是目的地集區，NTMS_CONTROL_ACCESS至來源集區，而且需要NTMS_USER_ACCESS至免費集區。 否則，來源和目的地集區都需要NTMS_CONTROL_ACCESS。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 ntmsapi.h
程式庫 Ntmsapi.lib
Dll Ntmsapi.dll

另請參閱

AllocateNtmsMedia

CreateNtmsMediaPool

媒體服務函式