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

待機するミリ秒数。オペレーター要求にチェックするには、タイムアウト値 0 を渡します。 INFINITE の値を指定した場合、この関数はタイムアウトしません。

この関数は、次のいずれかの値を返します。

値	意味
ERROR_CANCELLED	オペレーター要求が管理者によって取り消されました。
ERROR_INVALID_HANDLE	hSession パラメーターで指定された値が NULL であるか、無効です。
ERROR_INVALID_PARAMETER	パラメーター値の 1 つが無効です。
ERROR_NOT_CONNECTED	RSM サービスに接続できません。
ERROR_OBJECT_NOT_FOUND	演算子要求オブジェクトが見つかりません。オブジェクト要求はデータベースからフラッシュされます。 RSM がこのエラーを返す場合、アプリケーションは AllocateNtmsMedia などの関数を呼び出す必要があります。
ERROR_SUCCESS	関数は成功しました。
ERROR_TIMEOUT	dwTimeout パラメーターで指定された時間が、オペレーター要求の完了前に経過しました。

WaitForNtmsOperatorRequest 関数で指定されたオペレーター要求は、メディアの要求、メディアのライブラリ間の移動の要求、または RSM デバイスサービスの要求に使用されます。

アプリケーションは WaitForNtmsOperatorRequest を使用して、オペレーター要求の解決を待機します。要求は、満たす、拒否される、削除される、またはタイムアウトする可能性があります。

通常、アプリケーションは SubmitNtmsOperatorRequest 関数を使用してオペレーター要求を送信し、 WaitForNtmsOperatorRequest 関数を使用して解決を待機します。