次の方法で共有

ReserveNtmsCleanerSlot 関数 (ntmsapi.h)

  • [アーティクル]

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

ReserveNtmsCleanerSlot 関数は、ドライブ クリーナー カートリッジ用のライブラリ ユニットに 1 つのスロットを予約します。

構文

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

パラメーター

[in] hSession

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

[in] lpLibrary

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

[in] lpSlot

クリーナー カートリッジ用に予約されるスロットの一意識別子。

戻り値

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

値 説明
ERROR_ACCESS_DENIED
 ライブラリへのNTMS_CONTROL_ACCESSは拒否されます。 その他のセキュリティ エラーも考えられますが、セキュリティ サブシステム エラーを示します。
ERROR_ALREADY_RESERVED
 このスロットまたはライブラリ内の別のスロットは、クリーニング用に既に予約されています。 クリーナー・カートリッジ・スロットを変更するには、 ReleaseNtmsCleanerSlot 機能を使用して、現在予約されているクリーナー・スロットを最初に解放する必要があります。
ERROR_DEVICE_NOT_AVAILABLE
 ライブラリは現在接続されていません。
ERROR_INVALID_HANDLE
 hSession パラメーターで指定された値が無効です。
ERROR_INVALID_SLOT
 データベースからスロット定義を取得できません。
ERROR_NOT_CONNECTED
 RSM サービスに接続できません。
ERROR_SLOT_FULL
 クリーナー スロットが予約されていません。 指定されたスロットにメディアが含まれています。 予約は空のスロットでのみ実行できます。
ERROR_SLOT_NOT_PRESENT
 クリーナー スロットが予約されていません。 指定されたスロットは、現在ライブラリにインストールされていません。 このエラーは、少なくとも 1 つのカートリッジ・マガジンがライブラリーに欠落している場合に発生します。
ERROR_SUCCESS
 関数が正常にキューに入れられます。

解説

ReserveNtmsCleanerSlot 関数で予約されているスロットが存在し、空である必要があります。 ライブラリーは、クリーナー・カートリッジ用にまだスロットを予約してはなりません。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー ntmsapi.h
Library Ntmsapi.lib
[DLL] Ntmsapi.dll

関連項目

CleanNtmsDrive

クリーナー管理機能

EjectNtmsCleaner

InjectNtmsCleaner

ReleaseNtmsCleanerSlot