Méthode IVdsServiceLoader ::LoadService (vds.h)
[À compter de Windows 8 et Windows Server 2012, l’interface COM du service de disque virtuel est remplacée par l’API gestion du stockage Windows.]
Lance VDS sur l’ordinateur spécifié et retourne un pointeur vers l’objet de service.
Syntaxe
HRESULT LoadService(
[in] LPWSTR pwszMachineName,
[out] IVdsService **ppService
);
Paramètres
[in] pwszMachineName
Ce paramètre doit être défini sur NULL.
Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista et Windows Server 2003 : Ce paramètre contient le nom de l’ordinateur hôte. La définition de la valeur NULL entraîne le chargement et l’initialisation de VDS sur l’hôte local.
[out] ppService
Adresse d’un pointeur d’interface IVdsService . Les appelants doivent libérer l’interface quand elle n’est plus nécessaire en appelant la méthode IUnknown ::Release .
Valeur retournée
Cette méthode peut retourner des valeurs HRESULT standard, telles que E_INVALIDARG ou E_OUTOFMEMORY, et des valeurs de retour spécifiques à VDS. Il peut également retourner des codes d’erreur système convertis à l’aide de la macro HRESULT_FROM_WIN32 . Les erreurs peuvent provenir de VDS lui-même ou du fournisseur VDS sous-jacent utilisé. Les valeurs de retour possibles sont les suivantes.
| Code de retour | Description |
|---|---|
|
Le service a été lancé avec succès. |
Remarques
Bien que S_OK indique que VDS a été lancé avec succès, l’initialisation du service peut être incomplète lorsque la méthode est retournée. Pour cette raison, après avoir appelé cette méthode, vous devez appeler la méthode IVdsService ::WaitForServiceReady pour attendre la fin de l’initialisation de VDS.
Pour obtenir un exemple de code, consultez Chargement de VDS.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | vds.h |
| Bibliothèque | Uuid.lib |