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

La méthode GetAlgorithmName récupère le nom complet associé à un identificateur d’objet d’algorithme (OID).

Syntaxe

HRESULT GetAlgorithmName(
  [in]  ObjectIdGroupId        GroupId,
  [in]  ObjectIdPublicKeyFlags KeyFlags,
  [out] BSTR                   *pstrAlgorithmName
);

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

• 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_ANY
• XCN_CRYPT_OID_INFO_PUBKEY_SIGN_KEY_FLAG
• XCN_CRYPT_OID_INFO_PUBKEY_ENCRYPT_KEY_FLAG

[out] pstrAlgorithmName

Pointeur vers une variable BSTR qui contient le nom.

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.

Remarques

Vous pouvez utiliser la constante XCN_CRYPT_ENCRYPT_ALG_OID_GROUP_ID pour créer une valeur de paramètre GroupId qui prend en compte la taille de clé pour les algorithmes qui peuvent être identifiés par 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 vers la gauche par 16 et effectuez une combinaison or au niveau du bit décalé et XCN_CRYPT_ENCRYPT_ALG_OID_GROUP_ID.

Si vous définissez le paramètre GroupId sur autre chose que XCN_CRYPT_PUBKEY_ALG_OID_GROUP_ID, spécifiez XCN_CRYPT_OID_INFO_PUBKEY_ANY pour le paramètre KeyFlags .

Spécifications

Voir aussi

IObjectId