Partager via

IObjectId ::InitializeFromAlgorithmName, méthode (certenroll.h)

La méthode InitializeFromAlgorithmName initialise l’objet à partir d’un nom d’algorithme ou d’un identificateur d’objet. Cette méthode a été fournie principalement pour vous permettre d’initialiser l’objet à partir d’une API de chiffrement : nom d’algorithme CNG (Next Generation). Toutefois, vous pouvez spécifier n’importe quel nom OID. Cette méthode est activée sur le web.

Syntaxe

HRESULT InitializeFromAlgorithmName(
  [in] ObjectIdGroupId        GroupId,
  [in] ObjectIdPublicKeyFlags KeyFlags,
  [in] AlgorithmFlags         AlgFlags,
  [in] BSTR                   strAlgorithmName
);

Paramètres

[in] GroupId

Valeur d’énumération ObjectIdGroupId qui spécifie le groupe OID à rechercher. Il peut s’agir de l’un des groupes d’algorithmes suivants :

  • XCN_CRYPT_HASH_ALG_OID_GROUP_ID
  • XCN_CRYPT_ENCRYPT_ALG_OID_GROUP_ID
  • XCN_CRYPT_PUBKEY_ALG_OID_GROUP_ID
  • XCN_CRYPT_SIGN_ALG_OID_GROUP_ID
En outre, vous pouvez également spécifier des groupes qui ne contiennent pas d’algorithmes de chiffrement :
  • XCN_CRYPT_RDN_ATTR_OID_GROUP_ID
  • XCN_CRYPT_EXT_OR_ATTR_OID_GROUP_ID
  • XCN_CRYPT_ENHKEY_USAGE_OID_GROUP_ID
  • XCN_CRYPT_POLICY_OID_GROUP_ID
  • XCN_CRYPT_TEMPLATE_OID_GROUP_ID

[in] KeyFlags

Valeur d’énumération ObjectIdPublicKeyFlags qui spécifie s’il faut rechercher une signature ou un algorithme de chiffrement. Il peut s’agir de l’une des valeurs suivantes :

  • XCN_CRYPT_OID_INFO_PUBKEY_SIGN_KEY_FLAG
  • XCN_CRYPT_OID_INFO_PUBKEY_ENCRYPT_KEY_FLAG
Vous pouvez utiliser l’une ou l’autre valeur pour lever l’ambiguïté entre les algorithmes tels que RSA qui peuvent être utilisés pour chiffrer et signer des messages. Vous devez également spécifier XCN_CRYPT_PUBKEY_ALG_OID_GROUP_ID dans le paramètre GroupId .

[in] AlgFlags

Valeur d’énumération AlgorithmFlags . Il peut s’agir de l’une des valeurs suivantes :

  • AlgorithmFlagsNone
  • AlgorithmFlagsWrap
Si vous spécifiez XCN_CRYPT_ENCRYPT_ALG_OID_GROUP_ID pour le paramètre GroupId , vous pouvez utiliser l’énumération AlgorithmFlags pour rechercher un OID qui peut être utilisé pour encapsuler une clé. Par exemple, vous pouvez récupérer des informations sur l’algorithme AES128wrap si vous spécifiez une longueur de bit de 128 (voir la section Notes), définissez le paramètre strAlgorithmName sur AES et spécifiez AlgorithmFlagsWrap.

[in] strAlgorithmName

Variable BSTR qui contient le nom. Vous pouvez spécifier un nom ou un OID au format décimal en pointillé. La méthode vérifie que le format est cohérent avec la norme ASN.1 X.208. Pour plus d’informations sur les noms d’algorithmes CNG, consultez Identificateurs d’algorithme CNG.

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 incluent, mais ne sont pas limitées à celles du tableau suivant. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Retourner le code/la valeur Descriptif
CERTSRV_E_PROPERTY_EMPTY
 Les informations OID sont introuvables.
CRYPT_E_UNKNOWN_ALGO
 Le nom de l’algorithme n’est pas reconnu.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 L’objet est déjà initialisé.

Remarques

Vous pouvez utiliser les 16 bits supérieurs du paramètre GroupId pour spécifier la taille de clé pour les algorithmes qui acceptent une longueur de bits variable. Par exemple, pour initialiser un objet IObjectId à partir d’un algorithme AES 192 bits, spécifiez « AES » pour le paramètre strAlgorithmName , déplacez la longueur à gauche par 16 et effectuez une combinaison or au niveau du bit sur la longueur de bits décalée et la valeur GroupId .

Spécifications

Requirement Valeur
Client minimum requis Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
plateforme cible Fenêtres
Header certenroll.h
DLL CertEnroll.dll

Voir aussi

IObjectId

  • Last updated on