DeleteNtmsRequests 函式 (ntmsapi.h)

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

DeleteNtmsRequests 函式會從 RSM 資料庫刪除要求或要求清單。已移除處於已完成、失敗、拒絕或取消狀態的連結庫或操作員要求。無法刪除提交的要求、佇列要求、等候要求和進行中的要求。

語法

DWORD DeleteNtmsRequests(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId,
  [in] DWORD       dwType,
  [in] DWORD       dwCount
);

[in] hSession

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

[in] lpRequestId

要刪除的連結庫和操作員要求的標識符清單。

[in] dwType

要求類型。此參數可以是下列其中一個值。

值	意義
NTMS_LIBREQUEST	連結庫要求。
NTMS_OPREQUEST	運算子要求。

[in] dwCount

清單中的要求數目。

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

值	意義
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS電腦遭到拒絕。也可以發生其他安全性錯誤，但會指出安全性子系統錯誤。 Windowsxp： NTMS_CONTROL_ACCESS電腦遭到拒絕。也可以發生其他安全性錯誤，但會指出安全性子系統錯誤。
ERROR_DATABASE_FAILURE	資料庫無法存取或損毀。
ERROR_DATABASE_FULL	資料庫已滿。
ERROR_INVALID_PARAMETER	類型標識碼無效。
ERROR_INVALID_HANDLE	會話句柄遺失或無效。
ERROR_NOT_ENOUGH_MEMORY	處理期間記憶體配置失敗。
ERROR_SUCCESS	函式已成功執行。

如果找不到要求或要求清單，則不會傳回錯誤。