NTMS_LIBREQUESTINFORMATIONA 構造体 (ntmsapi.h)

  • [アーティクル]

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

NTMS_LIBREQUESTINFORMATION構造体は、RSM にキューに入れる作業要求に固有のプロパティを定義します。

構文

typedef struct _NTMS_LIBREQUESTINFORMATIONA {
  DWORD      OperationCode;
  DWORD      OperationOption;
  DWORD      State;
  NTMS_GUID  PartitionId;
  NTMS_GUID  DriveId;
  NTMS_GUID  PhysMediaId;
  NTMS_GUID  Library;
  NTMS_GUID  SlotId;
  SYSTEMTIME TimeQueued;
  SYSTEMTIME TimeCompleted;
  CHAR       szApplication[NTMS_APPLICATIONNAME_LENGTH];
  CHAR       szUser[NTMS_USERNAME_LENGTH];
  CHAR       szComputer[NTMS_COMPUTERNAME_LENGTH];
  DWORD      dwErrorCode;
  NTMS_GUID  WorkItemId;
  DWORD      dwPriority;
} NTMS_LIBREQUESTINFORMATIONA;

メンバー

OperationCode

アイテム操作。 次のいずれかの値を指定できます。

値 意味
NTMS_LM_CLASSIFY
 メディアを分類します。
NTMS_LM_CLEANDRIVE
 ドライブをクリーンアップします。
NTMS_LM_DISABLELIBRARY
 チェンジャーを無効にします。
NTMS_LM_DISABLEDRIVE
 ドライブを無効にします。
NTMS_LM_DISABLEMEDIA
 メディアを無効にします。
NTMS_LM_DISMOUNT
 ドライブからメディアをマウント解除します。
NTMS_LM_DOORACCESS
 ライブラリ ユニット ドアを介してメディアへのアクセスを許可します。
NTMS_LM_EJECT
 ライブラリからメディアを取り出します。
NTMS_LM_EJECTCLEANER
 クリーナーを取り出します。
NTMS_LM_ENABLELIBRARY
 チェンジャーを有効にします。
NTMS_LM_ENABLEDRIVE
 ドライブを有効にします。
NTMS_LM_ENABLEMEDIA
 メディアを有効にします。
NTMS_LM_INJECT
 メディアをライブラリに挿入します。
NTMS_LM_INJECTCLEANER
 クリーナーを挿入します。
NTMS_LM_INVENTORY
 ライブラリのインベントリを実行します。
NTMS_LM_MOUNT
 側をドライブにマウントします。
NTMS_LM_PROCESSOMID
 OMID を処理します。
NTMS_LM_RELEASECLEANER
 クリーナー スロットを解放します。
NTMS_LM_REMOVE
 キューから作業項目を削除します。
NTMS_LM_RESERVECLEANER
 クリーナー スロットを予約します。
NTMS_LM_UPDATEOMID
 OMID を更新します。
NTMS_LM_WRITESCRATCH
 自由なラベルを書き込みます。

OperationOption

作業項目オプション (コマンド固有)。

State

この作業項目の現在の状態。 次のいずれかの値を指定できます。

値 意味
NTMS_LM_QUEUED
 操作はキューに入れられます。
NTMS_LM_INPROCESS
 操作が処理中です。
NTMS_LM_PASSED
 操作は正常に完了しました。
NTMS_LM_FAILED
 操作がエラーで完了しました。
NTMS_LM_WAITING
 操作がブロックされています。
NTMS_LM_CANCELLED
 操作が取り消されました。
NTMS_LM_INVALID
 操作が無効です。

PartitionId

サービスを提供する側の一意識別子。

DriveId

サービス対象のドライブの一意識別子。

PhysMediaId

サービス対象の物理メディアの一意識別子。

Library

この要求のライブラリ。

SlotId

サービス対象の物理メディアのスロットの一意識別子。

TimeQueued

この要求が RSM にキューに登録されたシステム時刻。

TimeCompleted

RSM によってこの要求が完了したシステム時刻。

szApplication[NTMS_APPLICATIONNAME_LENGTH]

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

szUser[NTMS_USERNAME_LENGTH]

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

szComputer[NTMS_COMPUTERNAME_LENGTH]

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

dwErrorCode

状態NTMS_LM_FAILEDで を返す要求に対するエラーの戻り値。 これは システム エラー コードです。

WorkItemId

この要求に関連付けられた作業項目 ID。 これは現在、NTMS_LM_REMOVE要求で取り消される作業項目 ID を格納するために使用されます。

dwPriority

作業項目の優先度。

注釈

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

作業時間の GUID が時間の経過と同時に無効になる可能性があります。 たとえば、空きメディアを取り出すと、メディアの取り出し後に PMID が削除されます。 ただし、取り出しが完了すると、作業項目は更新されません。

注意

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

要件

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

こちらもご覧ください

NTMS_OBJECTINFORMATION