ReleaseNtmsCleanerSlot 関数 (ntmsapi.h)

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

ReleaseNtmsCleanerSlot 関数は、クリーニングカートリッジの既存のスロット予約を削除します。その後、スロットをデータ・カートリッジに使用できます。

構文

DWORD ReleaseNtmsCleanerSlot(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpLibrary
);

[in] hSession

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

[in] lpLibrary

クリーナースロットを解放するライブラリの一意識別子。

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

値	意味
ERROR_ACCESS_DENIED	ライブラリへのNTMS_CONTROL_ACCESSは拒否されます。その他のセキュリティエラーも考えられますが、セキュリティサブシステムエラーを示します。
ERROR_DEVICE_NOT_AVAILABLE	ライブラリは現在接続されていません。
ERROR_INVALID_HANDLE	hSession パラメーターで指定された値が無効です。
ERROR_NOT_CONNECTED	RSM サービスに接続できません。
ERROR_NO_SLOT_RESERVED	このライブラリには、よりクリーンなカートリッジ用に予約されたスロットがありません。
ERROR_SLOT_FULL	ライブラリには予約済みのクリーナーカートリッジスロットがありますが、スロットにはクリーナーカートリッジが含まれています (スロットは空である必要があります)。よりクリーンなカートリッジを取り出すには、 EjectNtmsCleaner 関数を使用します。
ERROR_SLOT_NOT_PRESENT	ライブラリには予約済みのクリーナーカートリッジスロットがありますが、指定されたスロットは現在ライブラリにインストールされていません。このエラーは、ライブラリに少なくとも 1 つのマガジンがない場合に発生する可能性があります。
ERROR_SUCCESS	関数が正常にキューに入れられます。

ReleaseNtmsCleanerSlot 関数を成功させるには、スロットが存在し、空である必要があります。ライブラリには、クリーニング用に予約されたスロットも必要です。