NTMS_LIBRARYINFORMATION 構造体 (ntmsapi.h)

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

NTMS_LIBRARYINFORMATION構造体は、ライブラリ オブジェクトに固有のプロパティを定義します。

構文

typedef struct _NTMS_LIBRARYINFORMATION {
  DWORD     LibraryType;
  NTMS_GUID CleanerSlot;
  NTMS_GUID CleanerSlotDefault;
  BOOL      LibrarySupportsDriveCleaning;
  BOOL      BarCodeReaderInstalled;
  DWORD     InventoryMethod;
  DWORD     dwCleanerUsesRemaining;
  DWORD     FirstDriveNumber;
  DWORD     dwNumberOfDrives;
  DWORD     FirstSlotNumber;
  DWORD     dwNumberOfSlots;
  DWORD     FirstDoorNumber;
  DWORD     dwNumberOfDoors;
  DWORD     FirstPortNumber;
  DWORD     dwNumberOfPorts;
  DWORD     FirstChangerNumber;
  DWORD     dwNumberOfChangers;
  DWORD     dwNumberOfMedia;
  DWORD     dwNumberOfMediaTypes;
  DWORD     dwNumberOfLibRequests;
  GUID      Reserved;
  BOOL      AutoRecovery;
  DWORD     dwFlags;
} NTMS_LIBRARYINFORMATION;

メンバー

LibraryType

ライブラリ型オブジェクト。 次のいずれかの値を指定できます。

意味
NTMS_LIBRARYTYPE_ONLINE
1 つ以上のドライブへのメディアのマウントとマウント解除を自動化するロボット要素。
NTMS_LIBRARYTYPE_STANDALONE
RSM に 1 つのドライブがあるライブラリとしてモデル化されたスタンドアロン ドライブ。
NTMS_LIBRARYTYPE_OFFLINE
ライブラリにないメディアは、オフライン ライブラリにあります。
NTMS_LIBRARYTYPE_UNKNOWN
ライブラリの種類を特定できません。

CleanerSlot

ライブラリごとに、これはクリーナー カートリッジに割り当てられたスロットを表します。 このメンバーが NULL の場合、このライブラリに対して定義されているクリーナー スロットはありません。

CleanerSlotDefault

ライブラリの既定または推奨されるクリーナー スロットを表します。 NULL の場合、優先スロットはありません。

LibrarySupportsDriveCleaning

ロボット制御下でのクリーニングが必要なドライブで使用されます。 TRUE の場合、ドライブの自動クリーニング操作が有効になります。

BarCodeReaderInstalled

ライブラリにバーコード リーダーがインストールされている場合は TRUE を 返します。それ以外の場合は FALSE を返します。

InventoryMethod

このライブラリのインベントリを実行するための既定またはユーザーが選択した方法。 (このメンバーは書き込み可能です)。次のいずれかの値を指定できます。

意味
NTMS_INVENTORY_FAST
ライブラリにバーコード リーダーがインストールされている場合、この値によってバーコード インベントリが実行されます。 ライブラリにバーコード リーダーがない場合、このフラグによって差分インベントリが実行されます (空から完全に遷移したスロットは分類されます)。
NTMS_INVENTORY_OMID
完全なインベントリには、ライブラリ内の両側をマウントし、メディアからメディア上の識別情報を読み取る必要があります。 この種類のインベントリは、一部のライブラリ ユニットでは非常に時間がかかる場合があります。
NTMS_INVENTORY_NONE
ライブラリ ドアが閉じられた後、インベントリは実行されません。 マウント ラベル チェックが失敗した場合は、インベントリが必要になる場合があります。

dwCleanerUsesRemaining

ライブラリ内のクリーナーに残っている使用の数。 クリーナーが存在しない場合、またはライブラリがクリーニングをサポートしていない場合、このメンバーは 0 です。

FirstDriveNumber

ライブラリ内の最初のドライブの番号。

dwNumberOfDrives

ライブラリ内のドライブの数。

FirstSlotNumber

ライブラリ内の最初のスロットの番号。

dwNumberOfSlots

ライブラリ内のスロットの数。

FirstDoorNumber

ライブラリ内の最初のアクセス ドアの番号。

dwNumberOfDoors

ライブラリ内のアクセス ドアの数。

FirstPortNumber

ライブラリ内の最初の挿入/取り出しポートの番号。

dwNumberOfPorts

ライブラリ内の挿入/取り出しポートの数。

FirstChangerNumber

ライブラリ内の最初のチェンジャーの番号。

dwNumberOfChangers

ライブラリ内のチェンジャーの数。

dwNumberOfMedia

オンライン ライブラリまたはオフライン ライブラリ内のメディアの数。

dwNumberOfMediaTypes

ライブラリでサポートされているメディアの種類の数。

dwNumberOfLibRequests

現在のライブラリ要求の数。

Reserved

予約済み。

AutoRecovery

このメンバーが TRUE の場合、マウントに失敗した場合は、完全なインベントリが実行されます。 障害は、ハードウェアまたはラベルの不一致のいずれかである可能性があります。 ATAPI CD ライブラリの場合、このパラメーターを無効にすることはできません。 既定は TRUE です。 大規模なライブラリ所有者は、この機能を無効にする必要があります。

dwFlags

このメンバーには、次の値の 1 つ以上を指定できます。

意味
NTMS_LIBRARYFLAG_FIXEDOFFLINE
ライブラリはオフライン ライブラリであり、存在しないライブラリではありません。
NTMS_LIBRARYFLAG_CLEANERPRESENT
クリーナーがチェンジャーに存在します。
NTMS_LIBRARYFLAG_IGNORECLEANERUSESREMAINING
クリーナー カートリッジは、残りのクリーニングの数を追跡するのではなく、ドライブをクリーンアップしなくなるまで使用されます。 このフラグは直接設定しないでください。 dwCleanerUsesRemaining の値に基づいて設定またはクリアされます。 dwCleanerUsesRemaining が0xFFFFFFFFの場合は設定され、それ以外の場合はクリアされます。
NTMS_LIBRARYFLAG_RECOGNIZECLEANERBARCODE
CLN を備えたバーコード・カートリッジは、識別するためにドライブに取り付けるのではなく、よりクリーンなカートリッジとして扱ってください。

注釈

オフライン ライブラリの場合、 LibraryTypedwNumberOfMedia のみが報告されます。 その他の値はすべて無視する必要があります。

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

要件

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

こちらもご覧ください

NTMS_OBJECTINFORMATION