DisableNtmsObject 函式 (ntmsapi.h)

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

DisableNtmsObject 函式會停用指定的 RSM 物件。

語法

DWORD DisableNtmsObject(
  [in] HANDLE      hSession,
  [in] DWORD       dwType,
  [in] LPNTMS_GUID lpObjectId
);

[in] hSession

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

[in] dwType

RSM 物件類型。此參數可以是 NtmsObjectsTypes 列舉類型的下列其中一個值。

[in] lpObjectId

RSM 物件的唯一標識符。

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

值	意義
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS至包含對象的連結庫遭到拒絕。可能會發生其他安全性錯誤，但表示安全性子系統錯誤。 Windowsxp： NTMS_CONTROL_ACCESS至包含對象的連結庫遭到拒絕。可能會發生其他安全性錯誤，但表示安全性子系統錯誤。
ERROR_DATABASE_FAILURE	資料庫無法存取或損毀。
ERROR_INVALID_HANDLE	會話句柄遺失或無效。
ERROR_INVALID_PARAMETER	遺漏物件標識碼或物件類型無效。 (如果物件類型不是NTMS_LIBRARY、NTMS_DRIVE或 NTMS_PHYSICAL_MEDIA.) ，則無效
ERROR_INVALID_STATE	對象已經停用。
ERROR_LIBRARY_OFFLINE	連結庫標識碼是指無法啟用或停用的離線連結庫。
ERROR_OBJECT_NOT_FOUND	物件不是有效的。
ERROR_SUCCESS	停用已排入佇列。

DisableNtmsObject 函式會將指定物件的 disable 命令排入佇列。當命令排入佇列時，函式會成功傳回。如果 RSM 忙碌中，命令可能需要一些時間才能完成。停用媒體時，RSM 會轉譯所有媒體端和相關聯的邏輯媒體無法使用。停用媒體傳回錯誤的所有要求。

若要從服務中移除磁碟驅動器或媒體變更程式，必須先停用磁碟驅動器或媒體變更器。

停用物件所包含的所有物件也會停用。例如，停用實體媒體片段會停用所有側邊。可能的話，當磁碟驅動器停用時，磁碟驅動器中的媒體會移除並放在其插槽中。