IVdsProviderPrivate::OnUnload メソッド (vdshwprv.h)

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

プロバイダーオブジェクトに対して、それ自体を初期化解除するように求めます。

構文

HRESULT OnUnload(
  [in] BOOL bForceUnload
);

[in] bForceUnload

true の場合、VDS はプロバイダーを強制的にアンロードしようとします。 false の場合、VDS はそのような試行を行いません。

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

リターンコード	説明
S_OK	プロバイダーがアンロードされます。
S_FALSE	現時点では、プロバイダーをアンロードできません。 VDS は後でもう一度試行します。

VDS は、プロバイダーオブジェクトへの参照を解放する直前に、このメソッドを呼び出します。参照カウントが 0 に低下すると、プロバイダーはアンロードします。 OnLoad メソッドが失敗した場合、VDS は OnUnload を呼び出しません。

実装者へのメモ: OnUnload の呼び出しがなくても、必要なすべてのクリーンを実行する必要があります。