Méthode IVssAdmin ::RegisterProvider (vsadmin.h)

Article
03/13/2024

La méthode RegisterProvider inscrit un nouveau fournisseur de cliché instantané.

Syntaxe

HRESULT RegisterProvider(
  [in] VSS_ID            pProviderId,
  [in] CLSID             ClassId,
  [in] VSS_PWSZ          pwszProviderName,
  [in] VSS_PROVIDER_TYPE eProviderType,
  [in] VSS_PWSZ          pwszProviderVersion,
  [in] VSS_ID            ProviderVersionId
);

Paramètres

[in] pProviderId

Le VSS_ID qui identifie de manière unique et permanente le fournisseur. Une fois défini, le paramètre ProviderId doit rester le même, même lorsque la révision logicielle est mise à jour. Un paramètre ProviderId ne doit être modifié que lorsque la fonctionnalité change suffisamment pour que les deux fournisseurs soient actifs sur le même système. Un demandeur peut utiliser le paramètre ProviderId pour demander qu’un fournisseur spécifique soit utilisé dans une création de cliché instantané.

[in] ClassId

CLSID du fournisseur.

[in] pwszProviderName

Nom du fournisseur.

[in] eProviderType

Valeur d’énumération VSS_PROVIDER_TYPE qui spécifie le type de fournisseur. Notez que VSS_PROV_HARDWARE n’est pas un type de fournisseur valide sur les versions du système d’exploitation client Windows. Les fournisseurs de matériel s’exécutent uniquement sur les versions du système d’exploitation Windows Server.

[in] pwszProviderVersion

Version du fournisseur.

[in] ProviderVersionId

Le VSS_ID qui identifie de manière unique cette version du fournisseur. La combinaison des paramètres pProviderId et ProviderVersionId doit être unique. Le paramètre ProviderVersionId peut être identique au paramètre ProviderVersionId d’un autre fournisseur.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Le fournisseur a été inscrit avec succès.
E_INVALIDARG	Une ou plusieurs des valeurs de paramètre ne sont pas valides. Par exemple, VSS_PROV_HARDWARE n’est pas un type de fournisseur valide sur les versions du système d’exploitation client Windows.
E_OUTOFMEMORY	Mémoire insuffisante ou autres ressources système.
E_ACCESSDENIED	L’appelant n’est pas un administrateur.
VSS_E_PROVIDER_ALREADY_REGISTERED	Le fournisseur a déjà été inscrit sur cet ordinateur.
VSS_E_UNEXPECTED	Erreur inattendue. Le code d’erreur est enregistré dans le fichier journal des erreurs. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS. Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge tant que Windows Server 2008 R2 et Windows 7. E_UNEXPECTED est utilisé à la place.

Remarques

Si le fournisseur de matériel est mis à jour, l’application d’installation doit appeler la méthode UnregisterProvider pour annuler l’inscription de la version obsolète, puis appeler la méthode RegisterProvider pour inscrire le fournisseur mis à jour.

Note Les fournisseurs de matériel ne peuvent être inscrits que sur les systèmes d’exploitation Windows Server.

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	vsadmin.h

Voir aussi

IVssAdmin

UnregisterProvider

Partager via