WaitForNtmsOperatorRequest 函式 (ntmsapi.h)

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

WaitForNtmsOperatorRequest 函式會等候指定的 RSM 運算符要求。

語法

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

[in] hSession

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

[in] lpRequestId

SubmitNtmsOperatorRequest 函式所建立的操作員要求標識碼。

[in] dwTimeout

要等候的毫秒數。若要檢查操作員要求，請傳遞零的逾時值。如果您指定 INFINITE 的值，此函式不會逾時。

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

值	意義
ERROR_CANCELLED	操作員要求已由系統管理員取消。
ERROR_INVALID_HANDLE	hSession 參數中指定的值為 NULL 或無效。
ERROR_INVALID_PARAMETER	其中一個參數值無效。
ERROR_NOT_CONNECTED	無法連線到 RSM 服務。
ERROR_OBJECT_NOT_FOUND	找不到運算元要求物件。物件要求會從資料庫排清。如果 RSM 傳回此錯誤，應用程式應該呼叫類似 AllocateNtmsMedia 的函式。
ERROR_SUCCESS	函式成功。
ERROR_TIMEOUT	dwTimeout 參數中指定的時間會在運算子要求完成之前經過。

使用 WaitForNtmsOperatorRequest 函式指定的操作員要求會用來要求媒體、要求媒體從一個連結庫移至另一個連結庫，或要求 RSM 裝置服務。

應用程式會使用 WaitForNtmsOperatorRequest 來等候運算符要求的解析。要求可以滿足、拒絕、刪除或逾時。

一般而言，應用程式會使用 SubmitNtmsOperatorRequest 函式來提交運算符要求，並使用 WaitForNtmsOperatorRequest 函式來等候其解析。