StrongNameSignatureGenerationEx, fonction

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

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

BOOLEAN 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 à l'aide de la fonction 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

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

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.

Si la fonction StrongNameSignatureGenerationEx 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::StrongNameSignatureGenerationEx

Méthode ICLRStrongName::StrongNameSignatureGeneration

Historique des modifications

Date	Historique	Motif
Juillet 2010	Lien ajouté à l'alternative recommandée.	Améliorations apportées aux informations.