IVdsAsync::QueryStatus メソッド (vdshwprv.h)

[Windows 8とWindows Server 2012以降、Virtual Disk Service COM インターフェイスは Windows Storage Management API に置き換えられます。

非同期操作が進行中であるか、正常に完了したか失敗したかを返します。

構文

HRESULT QueryStatus(
  [out] HRESULT *pHrResult,
  [out] ULONG   *pulPercentCompleted
);

[out] pHrResult

呼び出し元によって渡される非同期操作の HRESULT のアドレス。操作が進行中の場合、値は VDS_E_OPERATION_PENDING。操作が完了した場合、値は操作の返された HRESULT です。

[out] pulPercentCompleted

呼び出し元によって渡された ULONG のアドレス。非同期操作の状態をパーセンテージで示します。操作が進行中の場合、値は 0 から 99 の間です。操作が完了した場合、値は 100 です。操作の進行状況を見積もることができない場合、値は 0 です。

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

リターンコード/値	説明
S_OK	操作が進行中であるか、完了しています。
VDS_E_OPERATION_PENDING 0x80042409L	操作が進行中です。

QueryStatus メソッドは、操作の完了を待ってからを返しません。