AccessNtmsLibraryDoor 関数 (ntmsapi.h)

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

AccessNtmsLibraryDoor 関数は、指定したライブラリのドアのロックを解除します。ライブラリがビジー状態の場合、RSM は要求をキューに入れ、正常に返します。

構文

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

[in] hSession

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

[in] lpLibraryId

ライブラリオブジェクトの一意識別子。このライブラリは、ドアアクセスをサポートする必要があります。

[in] dwAction

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

値	意味
NTMS_INVENTORY_NONE	ユーザーがドアを閉じると、インベントリは実行されません。ただし、マウントラベルチェックが失敗した場合は、インベントリが実行されます。
NTMS_INVENTORY_OMID	ユーザーがドアを閉じると、メディア上の完全なインベントリが実行されます。各メディアの両側をマウントする必要があるため、時間がかかる場合があります。
NTMS_INVENTORY_FAST	ライブラリにバーコードリーダーがインストールされている場合、このフラグによってバーコードインベントリが実行されます。ライブラリにバーコードリーダーがない場合、このフラグによって差分インベントリが実行されます。ドアが開いている間、空のスロットに配置された各メディアでOMIDがチェックされます。
NTMS_INVENTORY_DEFAULT	ライブラリオブジェクトで指定された InventoryMethod を使用します ( 「NTMS_LIBRARYINFORMATION」を参照)。

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

値	意味
ERROR_ACCESS_DENIED	ライブラリへのNTMS_CONTROL_ACCESSは拒否されます。その他のセキュリティエラーも考えられますが、セキュリティサブシステムエラーを示します。
ERROR_DATABASE_FAILURE	データベースにアクセスできないか、破損しています。
ERROR_DATABASE_FULL	データベースがいっぱいです。
ERROR_INVALID_HANDLE	セッション ID が見つからないか、無効です。
ERROR_INVALID_PARAMETER	ライブラリ ID がありません。
ERROR_LIBRARY_OFFLINE	ライブラリ ID は、ドアのないオフラインライブラリを参照します。
ERROR_NOT_ENOUGH_MEMORY	処理中に割り当てエラーが発生しました。
ERROR_RESOURCE_DISABLED	ライブラリが無効になっています。
ERROR_RESOURCE_NOT_PRESENT	ライブラリにはドアがありません。
ERROR_SUCCESS	ドアアクセスはキューに入れられます。

一部のライブラリでは、RSM がプログラムによってドアをロックおよびロック解除する手段はありません。これらのライブラリを使用したこの関数の動作は、RSM がロック解除およびロックできるライブラリでの動作と同じです。