SetNtmsRequestOrder 関数 (ntmsapi.h)
[リムーバブル 記憶域マネージャー は、Windows 7 および Windows Server 2008 R2 以降では使用できません。
SetNtmsRequestOrder 関数は、指定した要求がライブラリ キューで処理される順序を設定します。
構文
DWORD SetNtmsRequestOrder(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpRequestId,
[in] DWORD dwOrderNumber
);
パラメーター
[in] hSession
OpenNtmsSession 関数によって返されるセッションを処理します。
[in] lpRequestId
ライブラリ要求の一意識別子。
[in] dwOrderNumber
要求をキューで処理する順序。
戻り値
この関数は、次のいずれかの値を返します。
| 値 | 意味 |
|---|---|
|
コンピューターへのNTMS_CONTROL_ACCESSが拒否されました。 その他のセキュリティ エラーも考えられますが、セキュリティ サブシステム エラーを示します。
Windows XP: アクセス権は必要ありません。 |
|
データベースにアクセスできないか、破損しています。 |
|
セッション ハンドルがないか、無効です。 |
|
ライブラリ要求識別子がありません。 |
|
指定した識別子を持つ要求オブジェクトが見つかりません。 |
|
関数は成功しました。 |
注釈
現在、NTMS_LM_MOUNT要求は注文番号を使用して並べ替えられています。
SetNtmsRequestOrder 関数によって設定される順序番号は、型が事前に定義された順序で処理されるため、要求の種類に固有です。 たとえば、NTMS_LM_DISMOUNT要求は、NTMS_LM_MOUNT要求の前に処理されます。 ただし、要求の特定のクラス内でキューを並べ替えることができます。 下位の順序付けられた要求が最初に処理されます。たとえば、1 は最初に処理された要求、2 は次に処理される要求などです。
要求をすぐに処理するために、アプリケーションは注文番号を 1 に設定できます。 処理を延期するには、アプリケーションで注文番号を非常に大きな数または0xFFFFFFFFに設定する必要があります。 現在 0 の注文番号を持つ要求の注文番号は変更できません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | ntmsapi.h |
| Library | Ntmsapi.lib |
| [DLL] | Ntmsapi.dll |