DismountNtmsDrive 関数 (ntmsapi.h)

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

DismountNtmsDrive 関数は、指定されたドライブ内のメディアをストレージスロットに移動するコマンドをキューに入れます。この関数は MountNtmsMedia 関数とペアにする必要があります。

構文

DWORD DismountNtmsDrive(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpDriveId
);

[in] hSession

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

[in] lpDriveId

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

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

値	意味
ERROR_ACCESS_DENIED	ライブラリへのNTMS_MODIFY_ACCESSは拒否されます。その他のセキュリティエラーも考えられますが、セキュリティサブシステムエラーを示します。 Windows XP: ライブラリへのNTMS_CONTROL_ACCESSは拒否されます。その他のセキュリティエラーも考えられますが、セキュリティサブシステムエラーを示します。
ERROR_DATABASE_FAILURE	データベースにアクセスできないか、破損しています。
ERROR_DATABASE_FULL	データベースがいっぱいです。
ERROR_DEVICE_NOT_AVAILABLE	ドライブまたはライブラリが有効になっていません。
ERROR_INVALID_DRIVE	ドライブ ID が無効です。
ERROR_INVALID_HANDLE	セッションハンドルがないか、無効です。
ERROR_INVALID_LIBRARY	ドライブのライブラリが無効です。
ERROR_INVALID_PARAMETER	ドライブ ID がありません。
ERROR_INVALID_STATE	ドライブにメディアが含まれていません。
ERROR_NOT_ENOUGH_MEMORY	処理中に割り当てエラーが発生しました。
ERROR_SUCCESS	関数は成功しました。

DismountNtmsDrive 関数で指定されたドライブが空の場合、またはメディアが開いている場合は、エラーが返されます。それ以外の場合、メディアはそのスロットに返されます。

スタンドアロンドライブのマウント解除要求により、ドライブがマウント解除可能な状態になり、成功が返されます。