次の方法で共有


IVdsServiceLoader::LoadService メソッド (vds.h)

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

指定したコンピューターで VDS を起動し、サービス オブジェクトへのポインターを返します。

構文

HRESULT LoadService(
  [in]  LPWSTR      pwszMachineName,
  [out] IVdsService **ppService
);

パラメーター

[in] pwszMachineName

このパラメーターは NULL に設定する必要があります。

Windows Server 2008 R2、Windows 7、Windows Server 2008、Windows Vista、Windows Server 2003: このパラメーターには、ホスト コンピューターの名前が含まれています。 これを NULL に設定すると、ローカル ホストで VDS が読み込まれ、初期化されます。

[out] ppService

IVdsService インターフェイス ポインターのアドレス。 呼び出し元は、 IUnknown::Release メソッドを呼び出すことによってインターフェイスが不要になったときに解放する必要があります。

戻り値

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

リターン コード 説明
S_OK
サービスが正常に起動しました。

注釈

S_OKは VDS が正常に起動したことを示しますが、メソッドが戻るときにサービスの初期化が不完全になる可能性があります。 このため、このメソッドを呼び出した後、VDS の初期化が完了するまで待機するには、 IVdsService::WaitForServiceReady メソッドを呼び出す必要があります。

コード例については、「 VDS の読み込み」を参照してください。

要件

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

こちらもご覧ください

IVdsService

IVdsService::WaitForServiceReady

IVdsServiceLoader