Partager via

StrongNameKeyGenEx, fonction

  • Article

Génère une nouvelle paire de clés publique/privée de la taille de clé spécifiée, pour l'utilisation d'un nom fort.

Cette fonction est déconseillée dans le .NET Framework version 4. Utilisez à la place la méthode ICLRStrongName::StrongNameKeyGenEx.

BOOLEAN StrongNameKeyGenEx (
    [in]  LPCWSTR   wszKeyContainer,
    [in]  DWORD     dwFlags,
    [in]  DWORD     dwKeySize,
    [out] BYTE      **ppbKeyBlob,
    [out] ULONG     *pcbKeyBlob
);

Paramètres

  • wszKeyContainer
    [in] Nom de conteneur de clé demandé. wszKeyContainer doit être une chaîne non vide, ou null pour générer un nom temporaire.

  • dwFlags
    [in] Spécifie s'il convient de laisser la clé enregistrée. Les valeurs suivantes sont prises en charge :

    • 0x00000000 - Utilisée lorsque wszKeyContainer est égal à null pour générer un nom de conteneur de clé provisoire.

    • 0x00000001 (SN_LEAVE_KEY) - Spécifie que la clé doit rester enregistrée.

  • dwKeySize
    [in] Taille demandée de la clé, en bits.

  • ppbKeyBlob
    [out] Paire de clés publique/privée retournée.

  • pcbKeyBlob
    [out] Taille en octets de ppbKeyBlob.

Valeur de retour

true en cas de réussite ; sinon, false.

Notes

Les versions 1.0 et 1.1 du .NET Framework requièrent une dwKeySize de 1024 bits pour signer un assembly avec un nom fort ; la version 2.0 ajoute la prise en charge des clés 2048 bits.

Une fois la clé récupérée, vous devez appeler la fonction StrongNameFreeBuffer pour libérer la mémoire allouée.

Si la fonction StrongNameKeyGenEx ne se termine pas correctement, appelez la fonction StrongNameErrorInfo pour récupérer la dernière erreur générée.

Configuration requise

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : StrongName.h

Bibliothèque : incluse en tant que ressource dans MsCorEE.dll

Versions du .NET Framework : 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0

Voir aussi

Référence

ICLRStrongName, interface

Autres ressources

Méthode ICLRStrongName::StrongNameKeyGenEx

Méthode ICLRStrongName::StrongNameKeyGen

Historique des modifications

Date

Historique

Motif

Juillet 2010

Lien ajouté à l'alternative recommandée.

Améliorations apportées aux informations.