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 関数を使用して解決を待機します。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー ntmsapi.h
Library Ntmsapi.lib
[DLL] Ntmsapi.dll

こちらもご覧ください

CancelNtmsOperatorRequest

演算子要求関数

SatisfyNtmsOperatorRequest

SubmitNtmsOperatorRequest