InventoryNtmsLibrary 関数 (ntmsapi.h)

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

InventoryNtmsLibrary 関数は、指定したライブラリのインベントリをキューに入れます。ライブラリがビジー状態の場合、RSM は InventoryNtmsLibrary をキューに入れ、成功を返します。

構文

DWORD InventoryNtmsLibrary(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpLibraryId,
  [in] DWORD       dwAction
);

[in] hSession

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

[in] lpLibraryId

ライブラリオブジェクトの一意識別子。

[in] dwAction

実行するアクション。このパラメーターには、次の値のいずれかを指定できます。

値	意味
NTMS_INVENTORY_OMID	メディア上の完全なインベントリが実行されます。各メディアの両側をドライブに取り付ける必要があります。これは時間のかかるプロセスです。
NTMS_INVENTORY_FAST	ライブラリにバーコードリーダーがインストールされている場合、このフラグによってバーコードインベントリが実行されます。ライブラリにバーコードリーダーがない場合、このフラグにより差分インベントリが実行されます (スロットが分類されます)。
NTMS_INVENTORY_DEFAULT	ライブラリオブジェクトで指定された InventoryMethod を使用します ( NTMS_LIBRARYINFORMATION参照)。
NTMS_INVENTORY_STOP	指定したライブラリの現在のインベントリを停止します。

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

値	意味
ERROR_ACCESS_DENIED	1 つ以上の RSM オブジェクトへのアクセスが拒否されます。
ERROR_DEVICE_NOT_AVAILABLE	ライブラリは現在接続されていません。
ERROR_INVALID_HANDLE	hSession パラメーターで指定された値が無効です。
ERROR_INVALID_LIBRARY	ライブラリはオフラインライブラリです。
ERROR_INVALID_PARAMETER	ライブラリ ID またはセッション ID が無効です。
ERROR_NOT_CONNECTED	RSM サービスに接続できません。
ERROR_SUCCESS	関数は成功しました。

存在しないライブラリはインベントリできません。

InventoryNtmsLibrary 関数は、ライブラリに現在メディアが含まれているすべてのスロットに分類/識別のマークを付けます。 InventoryNtmsLibrary 関数は、すべてのメディアがマークされるとを返します。