Méthode ICLRStrongName::StrongNameSignatureGenerationEx

Génère une signature de nom fort pour l'assembly spécifié, d'après les indicateurs spécifiés.

HRESULT StrongNameSignatureGenerationEx (
    [in]  LPCWSTR   wszFilePath,
    [in]  LPCWSTR   wszKeyContainer,
    [in]  BYTE      *pbKeyBlob,
    [in]  ULONG     cbKeyBlob,
    [out] BYTE      **ppbSignatureBlob,
    [out] ULONG     *pcbSignatureBlob,
    [in]  DWORD     dwFlags
);

Paramètres

  • wszFilePath
    [in] Chemin d'accès au fichier qui contient le manifeste de l'assembly pour lequel la signature de nom fort sera générée.

  • wszKeyContainer
    [in] Nom du conteneur de clé qui contient la paire de clés publique/privée.

    Si pbKeyBlob est null, wszKeyContainer doit spécifier un conteneur valide dans le fournisseur de services de chiffrement (CSP). Dans ce cas, la paire de clés stockée dans le conteneur est utilisée pour signer le fichier.

    Si pbKeyBlob est non null, la paire de clés est supposée être contenue dans l'objet binaire volumineux (BLOB) de clé.

  • pbKeyBlob
    [in] Pointeur vers la paire de clés publique/privée. Cette paire est au format créé par la fonction CryptExportKey Win32. Si pbKeyBlob est null, le conteneur de clé spécifié par wszKeyContainer est supposé contenir la paire de clés.

  • cbKeyBlob
    [in] Taille en octets de pbKeyBlob.

  • ppbSignatureBlob
    [out] Pointeur vers l'emplacement auquel le Common Language Runtime retourne la signature. Si ppbSignatureBlob est null, le runtime stocke la signature dans le fichier spécifié par wszFilePath.

    Si ppbSignatureBlob n'est pas null, le Common Language Runtime alloue de l'espace dans lequel retourner la signature. L'appelant doit libérer cet espace en utilisant la méthode ICLRStrongName::StrongNameFreeBuffer.

  • pcbSignatureBlob
    [out] Taille, en octets, de la signature retournée.

  • dwFlags
    [In] Une ou plusieurs des valeurs suivantes :

    • SN_SIGN_ALL_FILES (0x00000001) - Recalculez tous les hachages pour les modules liés.

    • SN_TEST_SIGN (0x00000002) - Signature de test de l'assembly.

Valeur de retour

S_OK si la méthode a été effectuée correctement ; sinon, une valeur HRESULT qui indique l'échec (consultez Valeurs communes HRESULT pour une liste).

Notes

Spécifiez null pour wszFilePath pour calculer la taille de la signature sans créer la signature.

La signature peut être stockée soit directement dans le fichier, soit retournée à l'appelant.

Si SN_SIGN_ALL_FILES est spécifié, mais qu'une clé publique n'est pas incluse (pbKeyBlob et wszFilePath sont null), les hachages pour les modules liés sont recalculés, mais l'assembly n'est pas signé à nouveau.

Si SN_TEST_SIGN est spécifié, l'en-tête du Common Language Runtime n'est pas modifié pour indiquer que l'assembly est signé avec un nom fort.

Spécifications

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : MetaHost.h

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

Versions du .NET Framework : 4

Voir aussi

Référence

ICLRStrongName, interface

Autres ressources

Méthode ICLRStrongName::StrongNameSignatureGeneration

Historique des modifications

Date

Historique

Motif

Avril 2011

A corrigé la valeur de retour.

Résolution des bogues de contenu.

Juillet 2010

Ajout d'une rubrique.

Améliorations apportées aux informations.