StrongNameGetPublicKeyEx, méthode

Article
05/10/2023

Obtient la clé publique à partir d’une paire de clés publique/privée et spécifie un algorithme de hachage et un algorithme de signature.

Syntaxe

HRESULT StrongNameGetPublicKey (
    [in]  LPCWSTR   pwzKeyContainer,  
    [in]  BYTE      *pbKeyBlob,  
    [in]  ULONG     cbKeyBlob,  
    [out] BYTE      **ppbPublicKeyBlob,  
    [out] ULONG     *pcbPublicKeyBlob  
    [in]  ULONG     uHashAlgId,  
    [in]  ULONG     uReserved,  
);

Paramètres

pwzKeyContainer
[in] Nom du conteneur de clés qui contient la paire de clés publique/privée. Si pbKeyBlob a la valeur null, szKeyContainer doit spécifier un conteneur valide au sein du fournisseur de services de chiffrement (CSP). Dans ce cas, la méthode StrongNameGetPublicKeyEx extrait la clé publique de la paire de clés stockée dans le conteneur.

Si pbKeyBlob n’est pas null, la paire de clés est supposée être contenue dans l’objet blob (Binary Large Object) de la clé.

Les clés doivent être des clés de signature 1024 bits Rivest-Shamir-Adleman (RSA). Aucun autre type de clé n’est pris en charge pour le moment.

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

cbKeyBlob
[in] Taille, en octets, de pbKeyBlob.

ppbPublicKeyBlob
[out] Objet blob de clé publique retourné. Le paramètre ppbPublicKeyBlob est alloué par le Common Language Runtime et retourné à l’appelant. L’appelant doit libérer cette mémoire en utilisant la méthode ICLRStrongName::StrongNameFreeBuffer.

pcbPublicKeyBlob
[out] Taille de l’objet blob de clé publique retournée.

uHashAlgId
[in] Algorithme de hachage d’assembly. Consultez la section Remarques pour obtenir la liste des valeurs acceptées.

uReserved
[in] Réservé à une utilisation future ; valeur par défaut null.

Valeur de retour

S_OK si la méthode a abouti ; sinon, valeur HRESULT qui indique l’échec (consultez Valeurs HRESULT courantes pour obtenir une liste).

Notes

La clé publique est contenue dans une structure PublicKeyBlob.

Le tableau suivant montre l’ensemble des valeurs acceptées pour le paramètre uHashAlgId.

Nom	Valeur
None	0
SHA-1	0x8004
SHA-256	0x800c
SHA-384	0x800d
SHA-512	0x800e

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : MetaHost.h

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

Versions de .NET Framework : Disponibles depuis la version 4.5

Partager via