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は VDS が正常に起動したことを示しますが、メソッドが戻るときにサービスの初期化が不完全になる可能性があります。 このため、このメソッドを呼び出した後、VDS の初期化が完了するまで待機するには、 IVdsService::WaitForServiceReady メソッドを呼び出す必要があります。
コード例については、「 VDS の読み込み」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | vds.h |
| Library | Uuid.lib |