GetNtmsRequestOrder 関数 (ntmsapi.h)

[リムーバブル記憶域マネージャーは、Windows 7 および Windows Server 2008 R2 以降では使用できません。

GetNtmsRequestOrder 関数は、指定した要求がライブラリキューで処理される順序を取得します。

構文

DWORD GetNtmsRequestOrder(
  [in]  HANDLE      hSession,
  [in]  LPNTMS_GUID lpRequestId,
  [out] LPDWORD     lpdwOrderNumber
);

[in] hSession

OpenNtmsSession 関数によって返されるセッションを処理します。

[in] lpRequestId

ライブラリ要求の一意識別子。

[out] lpdwOrderNumber

この要求がキューで処理される順序。

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

値	意味
ERROR_ACCESS_DENIED	コンピューターへのNTMS_CONTROL_ACCESSが拒否されました。その他のセキュリティエラーも考えられますが、セキュリティサブシステムエラーを示します。 Windows XP: アクセス権は必要ありません。
ERROR_DATABASE_FAILURE	データベースにアクセスできないか、破損しています。
ERROR_INVALID_HANDLE	セッションハンドルがないか、無効です。
ERROR_INVALID_PARAMETER	ライブラリ要求識別子がありません。
ERROR_OBJECT_NOT_FOUND	指定した識別子を持つ要求オブジェクトが見つかりません。
ERROR_SUCCESS	関数は成功しました。

GetNtmsRequestOrder 関数が lpdwOrderNumber で 0 を返す場合、この要求の順序付けは使用できません。注文番号は要求の種類に固有です。型は事前に定義された順序で処理されるためです。

たとえば、NTMS_LM_DISMOUNT要求は、NTMS_LM_MOUNT要求の前に処理されます。ただし、要求の特定のクラス内でキューを並べ替えることができます。下位の要求は最初に処理されます。たとえば、最初に処理される要求は 1、2 は次に処理される要求などです。

この注文番号、要求の種類、提出時刻、提出日を使用して、並べ替えられた順序でキューを表示できます。要求の種類、注文番号、送信時間は並べ替えを実行する必要があります。

現在、NTMS_LM_MOUNTでは、要求は注文番号を使用して並べ替えられます。