Metode IVdsServiceLoader::LoadService (vds.h)

Artikel
03/08/2023

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh API Manajemen Penyimpanan Windows.]

Meluncurkan VDS pada komputer yang ditentukan dan mengembalikan penunjuk ke objek layanan.

Sintaks

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

Parameter

[in] pwszMachineName

Parameter ini harus diatur ke NULL.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, dan Windows Server 2003: Parameter ini berisi nama komputer host. Mengaturnya ke NULL menyebabkan VDS dimuat dan diinisialisasi pada host lokal.

[out] ppService

Alamat penunjuk antarmuka IVdsService . Penelepon harus merilis antarmuka ketika tidak lagi diperlukan dengan memanggil metode IUnknown::Release .

Mengembalikan nilai

Metode ini dapat mengembalikan nilai HRESULT standar, seperti E_INVALIDARG atau E_OUTOFMEMORY, dan nilai pengembalian khusus VDS. Ini juga dapat mengembalikan kode kesalahan sistem yang dikonversi menggunakan makro HRESULT_FROM_WIN32 . Kesalahan dapat berasal dari VDS itu sendiri atau dari penyedia VDS yang mendasar yang sedang digunakan. Nilai yang mungkin dikembalikan termasuk yang berikut ini.

Menampilkan kode	Deskripsi
S_OK	Layanan berhasil diluncurkan.

Keterangan

Meskipun S_OK menunjukkan bahwa VDS telah berhasil diluncurkan, inisialisasi layanan dapat tidak lengkap ketika metode kembali. Untuk alasan ini, setelah memanggil metode ini, Anda harus memanggil metode IVdsService::WaitForServiceReady untuk menunggu inisialisasi VDS selesai.

Untuk contoh kode, lihat Memuat VDS.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	vds.h
Pustaka	Uuid.lib

Lihat juga

IVdsService

IVdsService::WaitForServiceReady

IVdsServiceLoader