IdentifyNtmsSlot 関数 (ntmsapi.h)

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

IdentifyNtmsSlot 関数は、ライブラリ内の指定されたスロット内のメディアを識別します。このコマンドは、識別が完了するとを返します。

構文

DWORD IdentifyNtmsSlot(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpSlotId,
  [in] DWORD       dwOption
);

[in] hSession

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

[in] lpSlotId

識別されるスロットオブジェクトの一意識別子。

[in] dwOption

このパラメーターには、次の値のいずれかを指定できます。

値	意味
NTMS_DISMOUNT_DEFERRED	メディア識別が完了した後は、"遅延" オプションでマウント解除されたかのように、メディアをドライブに残します。
NTMS_DISMOUNT_IMMEDIATE	メディア識別が完了したら、ドライブ内のメディアをマウント解除します。

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

値	意味
ERROR_ACCESS_DENIED	1 つ以上の RSM オブジェクトへのアクセスは拒否されます。
ERROR_INVALID_HANDLE	hSession パラメーターで指定された値が無効です。
ERROR_INVALID_PARAMETER	スロット ID または dwOption が無効です。
ERROR_SUCCESS	関数は成功しました。

スロットが空の場合、関数はERROR_SUCCESSを返しますが、新しいメディアレコードは表示されません。