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 |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour