Méthode IVdsAdmin ::RegisterProvider (vdshwprv.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.]
Inscrit le fournisseur de matériel spécifié auprès de VDS. Les fournisseurs de matériel appellent cette méthode.
Syntaxe
HRESULT RegisterProvider(
[in] VDS_OBJECT_ID providerId,
[in] CLSID providerClsid,
[in] LPWSTR pwszName,
[in] VDS_PROVIDER_TYPE type,
[in] LPWSTR pwszMachineName,
[in] LPWSTR pwszVersion,
[in] GUID guidVersionId
);
Paramètres
[in] providerId
GUID du fournisseur de matériel.
[in] providerClsid
Identificateur de classe COM (Clsid) du fournisseur de matériel.
[in] pwszName
Nom du fournisseur de matériel sous la forme d’une chaîne sans fin et lisible par l’utilisateur.
[in] type
Types de fournisseurs énumérés par VDS_PROVIDER_TYPE. Utilisez la valeur VDS_PT_HARDWARE pour inscrire un fournisseur de matériel auprès de VDS.
[in] pwszMachineName
Nom de l’ordinateur sur lequel le fournisseur de matériel s’exécute ; chaîne avec fin null, lisible par l’homme. Utilisez NULL pour référencer l’ordinateur actuel.
[in] pwszVersion
Version du fournisseur sous la forme d’une chaîne sans fin et lisible par l’utilisateur.
[in] guidVersionId
GUID de cette version du fournisseur.
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/valeur de retour | Description |
---|---|
|
ProviderId est déjà inscrit. Une seule version d’un fournisseur peut être inscrite à un moment donné. |
Remarques
Si nécessaire, appelez UnregisterProvider pour supprimer un fournisseur avant d’inscrire une nouvelle version.
Un fournisseur in-process appelle cette méthode à partir de DllRegisterServer ; tandis qu’un fournisseur hors processus appelle à partir de la fonction WinMain .
Les fournisseurs de matériel ne doivent pas cesser de s’exécuter pendant l’exécution 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 | vdshwprv.h |
Bibliothèque | Uuid.lib |