Metodo IVdsServiceLoader::LoadService (vds.h)

[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.]

Avvia VDS nel computer specificato e restituisce un puntatore all'oggetto servizio.

Sintassi

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

Parametri

[in] pwszMachineName

Questo parametro deve essere impostato su NULL.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista e Windows Server 2003: Questo parametro contiene il nome del computer host. Impostandolo su NULL , il VDS viene caricato e inizializzato nell'host locale.

[out] ppService

Indirizzo di un puntatore all'interfaccia IVdsService . I chiamanti devono rilasciare l'interfaccia quando non è più necessaria chiamando il metodo IUnknown::Release .

Valore restituito

Questo metodo può restituire valori HRESULT standard, ad esempio E_INVALIDARG o E_OUTOFMEMORY e valori restituiti specifici di VDS. Può anche restituire codici di errore di sistema convertiti usando la macro HRESULT_FROM_WIN32 . Gli errori possono provenire dal VDS stesso o dal provider VDS sottostante in uso. I valori restituiti possibili includono quanto segue.

Codice restituito	Descrizione
S_OK	Il servizio è stato avviato correttamente.

Commenti

Anche se S_OK indica che il VDS è stato avviato correttamente, l'inizializzazione del servizio può essere incompleta al termine del metodo. Per questo motivo, dopo aver chiamato questo metodo, è necessario chiamare il metodo IVdsService::WaitForServiceReady per attendere il completamento dell'inizializzazione VDS.

Per un esempio di codice, vedere Caricamento di VDS.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vds.h
Libreria	Uuid.lib

Vedi anche

IVdsService

IVdsService::WaitForServiceReady

IVdsServiceLoader