Méthode IVdsAdmin ::RegisterProvider (vdshwprv.h)

Article
03/13/2024

[À 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
VDS_E_ALREADY_REGISTERED 0x80042403L	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

IVdsAdmin

IVdsAdmin ::UnregisterProvider

VDS_PROVIDER_TYPE

Share via