NTMS_OPREQUESTINFORMATIONA 構造体 (ntmsapi.h)

  • [アーティクル]

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

NTMS_OPREQUESTINFORMATION構造体は、RSM のオペレーター要求システム制御に固有のプロパティを定義します。

構文

typedef struct _NTMS_OPREQUESTINFORMATIONA {
  DWORD      Request;
  SYSTEMTIME Submitted;
  DWORD      State;
  CHAR       szMessage[NTMS_MESSAGE_LENGTH];
  DWORD      Arg1Type;
  NTMS_GUID  Arg1;
  DWORD      Arg2Type;
  NTMS_GUID  Arg2;
  CHAR       szApplication[NTMS_APPLICATIONNAME_LENGTH];
  CHAR       szUser[NTMS_USERNAME_LENGTH];
  CHAR       szComputer[NTMS_COMPUTERNAME_LENGTH];
} NTMS_OPREQUESTINFORMATIONA;

メンバー

Request

オペレーター要求の種類。 これには、次のいずれかの値を指定できます。

値 意味
NTMS_OPREQ_NEWMEDIA
 メディアを割り当てようとしているアプリケーションは、使用可能なメディアがない場合に、新しいメディアのオペレーター要求を送信します。 このフラグが設定されている場合、 Arg1 メンバーは、新しいメディアを必要とするメディア プールの GUID に設定する必要があります。 必要に応じて、 Arg2 メンバーを、新しいメディアを配置する必要がある特定のライブラリに設定できます。
NTMS_OPREQ_CLEANER
 RSM は、クリーン操作がキューに入れられ、クリーナーがオンラインでなく、ドライブで使用可能な場合に、クリーナーのオペレーター要求を送信します。 このフラグが設定されている場合、 Arg1 メンバーはクリーニング カートリッジを必要とするライブラリの GUID に設定する必要があります。
NTMS_OPREQ_DEVICESERVICE
 アプリケーションまたは RSM は、changer デバイスまたはドライブで問題が発生したときに、ドライブ サービスのオペレーター要求を送信します。 このフラグが設定されている場合、 Arg1 メンバーはサービスを必要とするデバイスの GUID に設定する必要があります。
NTMS_OPREQ_MOVEMEDIA
 アプリケーションまたは RSM は、指定されたメディアを移動してオフライン メディアのマウントにサービスを提供するか、メディアをオフライン ライブラリに取り出すオペレーター要求を送信します。 このフラグが設定されている場合は、移動する物理メディアの GUID に Arg1 メンバーを設定し、 Arg2 メンバーをこのメディアを移動するライブラリの GUID に設定する必要があります。
NTMS_OPREQ_MESSAGE
 アプリケーション固有のオペレーター要求。 テキストのみ。

Submitted

オペレーター要求が送信されたシステム時刻。

State

オペレーター サービス要求の現在の状態。 これには、次のいずれかの値を指定できます。

値 意味
NTMS_OPSTATE_SUBMITTED
 オペレーター要求は送信されましたが、オペレーター・コンソールでは読み取られません。
NTMS_OPSTATE_ACTIVE
 オペレーター要求は 1 つ以上のオペレーター・コンソールによって読み取られ、処理中である可能性があります。
NTMS_OPSTATE_INPROGRESS
 ユーザーはこのオペレーター要求を確認し、サービスの実行中です。
NTMS_OPSTATE_REFUSED
 ユーザーがオペレーター サービス要求を拒否しました。
NTMS_OPSTATE_COMPLETE
 ユーザーがオペレーター サービス要求を完了しました。

szMessage[NTMS_MESSAGE_LENGTH]

演算子メッセージ テキスト。

Arg1Type

Arg1 オブジェクトの型。 これには、次のいずれかの値を指定できます。

値 意味
NTMS_UNKNOWN
 Arg1Type にオブジェクトが指定されていません。
NTMS_CHANGER
 中の変更オブジェクト。
NTMS_DRIVE
 ドライブ オブジェクト。
NTMS_IEDOOR
 ライブラリ ドア オブジェクト。
NTMS_IEPORT。
 ライブラリの挿入/取り出しポート オブジェクト
NTMS_LIBRARY
 ライブラリ オブジェクト。
NTMS_PARTITION
 Side オブジェクト。
NTMS_PHYSICAL_MEDIA
 物理メディア オブジェクト。
NTMS_STORAGESLOT
 ライブラリ スロット オブジェクト。

Arg1

参照オブジェクトを必要とする移動要求またはその他の演算子要求に使用される Arg1 オブジェクト ID。 このオブジェクトの目的は、オペレーター要求の種類によって異なります。 Arg1 の適切な使用方法については、「要求の説明」を参照してください。

Arg2Type

Arg2 オブジェクトの型。 これには、次のいずれかの値を指定できます。

値 意味
NTMS_UNKNOWN
 Arg2Type にオブジェクトが指定されていません。
NTMS_LIBRARY
 ライブラリ オブジェクト。

Arg2

2 番目の参照オブジェクトを必要とする演算子要求に使用される Arg2 オブジェクト ID。 このオブジェクトの目的は、オペレーター要求の種類によって異なります。 Arg2 の適切な使用方法については、「要求の説明」を参照してください。

szApplication[NTMS_APPLICATIONNAME_LENGTH]

オペレーター要求を送信したアプリケーション。

szUser[NTMS_USERNAME_LENGTH]

オペレーター要求を送信したコンピューターにログオンした対話型ユーザー。

szComputer[NTMS_COMPUTERNAME_LENGTH]

オペレーター要求を送信したコンピューター。

注釈

NTMS_OPREQUESTINFORMATION構造体は、NTMS_OBJECTINFORMATION構造体に含まれています。

注意

ntmsapi.h ヘッダーは、NTMS_OPREQUESTINFORMATIONをエイリアスとして定義します。これは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header ntmsapi.h

こちらもご覧ください

NTMS_OBJECTINFORMATION