CancelNtmsLibraryRequest 函式 (ntmsapi.h)

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

CancelNtmsLibraryRequest 函式會取消未處理的 RSM 要求，例如對 CleanNtmsDrive 函式的呼叫。如果連結庫忙碌中，RSM 會將取消排入佇列，並傳回成功。

語法

DWORD CancelNtmsLibraryRequest(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId
);

[in] hSession

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

[in] lpRequestId

要取消之連結庫要求的唯一標識符。

若要擷取現有連結庫要求的清單，請使用 EnumerateNtmsObject 函式。

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

值	意義
ERROR_ACCESS_DENIED	只有 RSM 伺服器的系統管理員可以取消連結庫要求。如果目前正在處理要求且無法刪除，也會傳回此錯誤。
ERROR_INVALID_HANDLE	會話句柄遺失或無效。
ERROR_NOT_ENOUGH_MEMORY	處理期間發生配置失敗。
ERROR_OBJECT_NOT_FOUND	找不到連結庫要求對象識別碼。如果在發出取消之前完成要求，或指定無效的要求標識符時，就會發生此錯誤。
ERROR_SUCCESS	連結庫要求已排入佇列以進行取消。