ICspInformation ::InitializeFromType, méthode (certenroll.h)

Article
02/28/2024

La méthode InitializeFromType initialise l’objet à partir du fournisseur de chiffrement par défaut.

Syntaxe

HRESULT InitializeFromType(
  [in]           X509ProviderType Type,
  [in, optional] IObjectId        *pAlgorithm,
  [in]           VARIANT_BOOL     MachineContext
);

Paramètres

[in] Type

Valeur d’énumération X509ProviderType qui définit le type de fournisseur.

Si vous spécifiez XCN_PROV_NONE et définissez le paramètre pAlgorithm sur une valeur autre que NULL, le fournisseur d’API de chiffrement : Nouvelle génération (CNG) par défaut est utilisé.
Si vous spécifiez une valeur autre que XCN_PROV_NONE et que vous définissez le paramètre pAlgorithm sur NULL, le fournisseur de services de chiffrement hérité (CSP) par défaut est utilisé.

[in, optional] pAlgorithm

Pointeur vers une interface IObjectId qui représente un OID d’algorithme. Ce paramètre est facultatif et peut être NULL. Pour plus d’informations, consultez le paramètre Type .

[in] MachineContext

Variable VARIANT_BOOL qui indique s’il faut utiliser l’ordinateur ou le contexte utilisateur pour déterminer le fournisseur par défaut pour le type de fournisseur spécifié. Spécifiez VARIANT_TRUE pour l’ordinateur et VARIANT_FALSE pour l’utilisateur.

Valeur retournée

Si la fonction réussit, la fonction retourne S_OK.

Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur. Les valeurs possibles sont notamment celles figurant dans le tableau suivant. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Code/valeur de retour	Description
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	L’objet est déjà initialisé.

Remarques

La méthode InitializeFromType valide le type spécifié et l’enregistre dans la propriété Type , récupère le fournisseur par défaut et définit les valeurs de propriété suivantes sur l’objet ICspInformation :

La méthode ajoute les algorithmes disponibles à la collection ICspAlgorithms retournée par la propriété CspAlgorithms . Appelez la méthode InitializeFromName pour initialiser l’objet à partir d’un nom CSP.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certenroll.h
DLL	CertEnroll.dll

Voir aussi

ICspInformation

Partager via