ICspInformation ::InitializeFromType, méthode (certenroll.h)
La méthode InitializeFromType initialise l’objet à partir du fournisseur de chiffrement par défaut.
HRESULT InitializeFromType(
[in] X509ProviderType Type,
[in, optional] IObjectId *pAlgorithm,
[in] VARIANT_BOOL MachineContext
);
[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.
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 |
---|---|
|
L’objet est déjà initialisé. |
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 :
- CspAlgorithms
- HasHardwareRandomNumberGenerator
- IsHardwareDevice
- IsRemovable
- IsSmartCard
- IsSoftwareDevice
- KeySpec
- LegacyCsp
- MaxKeyContainerNameLength
- Nom
- Valide
- Version
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.
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 |