DismountNtmsMedia 関数 (ntmsapi.h)

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

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

構文

DWORD DismountNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId,
  [in] DWORD       dwCount,
  [in] DWORD       dwOptions
);

パラメーター

[in] hSession

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

[in] lpMediaId

少なくとも 1 つの論理メディアまたは辺の配列。

[in] dwCount

lpMediaId パラメーター内のメディア識別子の数。

[in] dwOptions

オプション。 このパラメーターには、次の値を指定できます。

値 意味
NTMS_DISMOUNT_DEFERRED
 メディアの状態をマウント解除可能としてマークし、メディアをドライブに保持します。 後続のマウント要求は、マウント解除またはマウント解除可能なドライブを使用して満たされます。 既定値は、すぐにマウントを解除することです。
NTMS_DISMOUNT_IMMEDIATE
 ドライブのマウントを直ちに解除します。

戻り値

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

値 意味
ERROR_ACCESS_DENIED
 メディアを含むメディア プールまたはライブラリへのNTMS_USE_ACCESSは拒否されます。 その他のセキュリティ エラーも考えられますが、セキュリティ サブシステム エラーを示します。
ERROR_DATABASE_FAILURE
 データベースにアクセスできないか、破損しています。
ERROR_DATABASE_FULL
 データベースがいっぱいです。
ERROR_DEVICE_NOT_AVAILABLE
 マウント解除を実行するために必要な 1 つ以上のリソースは、現在使用できません (おそらく無効)。
ERROR_INVALID_LIBRARY
 メディアを含むライブラリが無効です。
ERROR_INVALID_MEDIA
 指定されたメディアの少なくとも 1 つが無効です。
ERROR_INVALID_STATE
 マウント解除中に予期しないメディアまたはデバイスの状態が発生しました。
ERROR_MEDIA_OFFLINE
 指定されたメディアがオフラインです。
ERROR_MEDIA_NOT_AVAILABLE
 マウントを実行するために必要な 1 つ以上のメディア リソースは、現在使用できません (おそらく無効)。
ERROR_NOT_ENOUGH_MEMORY
 処理中にメモリ割り当てエラーが発生しました。
ERROR_SUCCESS
 メディアのマウント解除がキューに登録されています。
ERROR_TIMEOUT
 タイムアウト イベントは、アプリケーションが 1 つ以上のリソースを取得しようとしたときに期限切れになりました。

注釈

アプリケーションで指定されたメディアを使用した後、アプリケーションでドライブ リソースを解放するには、 DismountNtmsMedia 関数を使用する必要があります。 リリースされていないメディアは、他の RSM セッションでは使用できません。

DismountNtmsMedia 関数は、操作が RSM でキューに登録されるとすぐにを返します。 アプリケーションは、サイド状態がアイドル状態になるまで待機できます。

要件

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

こちらもご覧ください

Media Services 関数

MountNtmsMedia

  • 最終更新: