DismountNtmsMedia 函式 (ntmsapi.h)

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

DismountNtmsMedia 函式會將命令排入佇列，將磁碟驅動器中的指定媒體移至其記憶體。此函式應該與 MountNtmsMedia 函式配對。

語法

DWORD DismountNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId,
  [in] DWORD       dwCount,
  [in] DWORD       dwOptions
);

[in] hSession

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

[in] lpMediaId

至少一個邏輯媒體或側邊的數位。

[in] dwCount

lpMediaId 參數中的媒體標識碼數目。

[in] dwOptions

選項。此參數可以是下列值。

值	意義
NTMS_DISMOUNT_DEFERRED	將媒體狀態標示為 [可卸除]，並將媒體保留在磁碟驅動器中。使用卸除或卸除的磁碟驅動器滿足後續掛接要求。預設值是立即卸除。
NTMS_DISMOUNT_IMMEDIATE	立即卸除磁碟驅動器。

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

值	意義
ERROR_ACCESS_DENIED	NTMS_USE_ACCESS至包含媒體的媒體集區或媒體櫃遭到拒絕。其他安全性錯誤也是可行的，但它們會指出安全性子系統錯誤。
ERROR_DATABASE_FAILURE	資料庫無法存取或損毀。
ERROR_DATABASE_FULL	資料庫已滿。
ERROR_DEVICE_NOT_AVAILABLE	目前無法使用執行卸除所需的一或多個資源， (可能停用) 。
ERROR_INVALID_LIBRARY	包含媒體的連結庫無效。
ERROR_INVALID_MEDIA	至少有一個指定的媒體無效。
ERROR_INVALID_STATE	卸除期間發生非預期的媒體或裝置狀態。
ERROR_MEDIA_OFFLINE	指定的媒體已離線。
ERROR_MEDIA_NOT_AVAILABLE	目前無法使用執行掛接所需的一或多個媒體資源， (可能停用) 。
ERROR_NOT_ENOUGH_MEMORY	處理期間發生記憶體配置失敗。
ERROR_SUCCESS	媒體卸除已排入佇列。
ERROR_TIMEOUT	當應用程式嘗試取得一或多個資源時，逾時事件已過期。

應用程式必須使用 DismountNtmsMedia 函式，在應用程式使用指定的媒體之後釋放磁碟驅動器資源。其他 RSM 會話無法使用未發行的媒體。

DismountNtmsMedia 函式會在作業以 RSM 排入佇列時立即傳回。應用程式可以等候側邊狀態變成閑置狀態。