IVdsVolumeMF3::OfflineVolume メソッド (vds.h)
[Windows 8とWindows Server 2012以降、仮想ディスク サービス COM インターフェイスは Windows Storage Management API に置き換えられます。
IOCTL_VOLUME_OFFLINEコントロール コードを使用して、ボリューム を オフラインにします。
構文
HRESULT OfflineVolume();
戻り値
このメソッドは、E_INVALIDARGやE_OUTOFMEMORYなどの標準の HRESULT 値と、 VDS 固有の戻り値を返すことができます。 また、HRESULT_FROM_WIN32 マクロを使用して、変換されたシステム エラー コードを返すこともできます。 エラーは、VDS 自体または使用されている基になる VDS プロバイダー から発生する可能性があります。 可能な戻り値は次のとおりです。
リターン コード | 説明 |
---|---|
|
メソッドは正常に完了しました。 |
解説
ボリュームが既にオフラインの場合、 OfflineVolume メソッドはS_OKを返します。
ボリュームがオフラインの場合、すべての読み取り、書き込み、および IOCTL 要求は 、ERROR_NOT_READYで失敗します。 システムまたはブート ボリュームをオフラインにすることはできません。
ボリュームがオンラインの場合、ボリュームに送信されるすべての要求が受け入れられます。
オンラインのボリュームがマウント解除されると、ボリュームを開く次の呼び出しによって、ボリュームがマウントされます。 ボリュームをオフラインにすると、マウント解除されたボリュームが再びマウントされなくなります。 ボリュームのマウントを解除するには、 IVdsVolumeMF::D ismount メソッドを 使用します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | vds.h |
Library | Uuid.lib |