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 |
|---|---|
|
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 |