ReserveNtmsCleanerSlot 函式 (ntmsapi.h)

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

ReserveNtmsCleanerSlot函式會在程式庫單位中保留單一位置，以取得更簡潔的磁片磁碟機。

語法

DWORD ReserveNtmsCleanerSlot(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpLibrary,
  [in] LPNTMS_GUID lpSlot
);

[in] hSession

OpenNtmsSession 函式所傳回之會話的控制碼。

[in] lpLibrary

程式庫的唯一識別碼，以保留更簡潔的位置。

[in] lpSlot

要保留給清除器清理工具之位置的唯一識別碼。

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

值	意義
ERROR_ACCESS_DENIED	程式庫NTMS_CONTROL_ACCESS遭到拒絕。也可以發生其他安全性錯誤，但會指出安全性子系統錯誤。
ERROR_ALREADY_RESERVED	此位置或程式庫中的另一個位置已經保留供清除。若要變更清除器清理器位置，必須先使用 ReleaseNtmsCleanerSlot 函式來釋放目前保留的清除器位置。
ERROR_DEVICE_NOT_AVAILABLE	程式庫目前未連線。
ERROR_INVALID_HANDLE	hSession參數中指定的值無效。
ERROR_INVALID_SLOT	無法從資料庫擷取位置定義。
ERROR_NOT_CONNECTED	無法連線到 RSM 服務。
ERROR_SLOT_FULL	未保留更簡潔的位置。指定的位置有媒體。保留只能在空白位置上執行。
ERROR_SLOT_NOT_PRESENT	未保留更簡潔的位置。指定的位置目前未安裝在程式庫中。如果媒體櫃中至少有一個雜誌遺失，就會發生此錯誤。
ERROR_SUCCESS	函式已成功排入佇列。

使用 ReserveNtmsCleanerSlot 函式保留的位置必須存在且空白。程式庫不能已經有保留給更簡潔的裝訂位置。