IVdsVolumeShrink::QueryMaxReclaimableBytes メソッド (vds.h)

  • [アーティクル]

[Windows 8とWindows Server 2012以降、仮想ディスク サービス COM インターフェイスは Windows Storage Management API に置き換えられます。

現在のボリュームから再利用できる最大バイト数を取得します。

構文

HRESULT QueryMaxReclaimableBytes(
  [out] ULONGLONG *pullMaxNumberOfReclaimableBytes
);

パラメーター

[out] pullMaxNumberOfReclaimableBytes

正常に完了すると、現在のボリュームから再利用できる最大バイト数を受け取る変数へのポインター。 この数は、常にファイル システム クラスター サイズの倍数になります。これは、ディスク セクター サイズの倍数になります。 このパラメーターは必須であり、null にすることはできません。

戻り値

このメソッドは、E_INVALIDARGやE_OUTOFMEMORYなどの標準の HRESULT 値と、 VDS 固有の戻り値を返すことができます。 また、HRESULT_FROM_WIN32 マクロを使用して、変換されたシステム エラー コードを返すこともできます。 エラーは、VDS 自体または使用されている基になる VDS プロバイダー から発生する可能性があります。 可能な戻り値は次のとおりです。

リターン コード/値 説明
S_OK
 メソッドは正常に完了しました。
VDS_E_CANNOT_SHRINK
0x8004251EL
 ボリュームは、ファイル システムでサポートされていないため、圧縮できません。
VDS_E_DISK_REMOVEABLE
0x8004255AL
 この操作は、リムーバブル メディアではサポートされていません。
RPX_X_NULL_REF_POINTER
0x800706F4
 pullMaxNumberOfReclaimableBytes パラメーターが入力時に null でした。

注釈

このメソッドは、実際に使用可能なバイト数よりも多くの再利用可能なバイトを返すことができます。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー vds.h
Library Uuid.lib

こちらもご覧ください

IVdsVolumeShrink