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

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

プロバイダーに自身の初期化を求め、プロバイダーが必要なインターフェイスを取得するために使用するコールバックオブジェクトを渡します。

構文

HRESULT OnLoad(
  [in] LPWSTR   pwszMachineName,
  [in] IUnknown *pCallbackObject
);

[in] pwszMachineName

このパラメーターは予約されています。

[in] pCallbackObject

コールバックオブジェクトへのポインター。

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

リターンコード/値	説明
S_OK	プロバイダーが初期化されます。
VDS_E_INITIALIZED_FAILED 0x80042401L	プロバイダーの初期化に失敗しました。

VDS は、プロバイダーで CoCreateInstance メソッドを呼び出した直後に、このメソッドを呼び出します。

実装者は、このメソッドを実装する必要があります。 IUnknown::QueryInterface メソッドを呼び出して、IVdsAdviseSink インターフェイスを照会します。