StrongNameGetPublicKey, fonction

Article
08/10/2011

Obtient la clé publique d'une paire de clés publique/privée. La paire de clés peut être fournie soit sous la forme d'un nom de conteneur de clé dans un fournisseur de services de chiffrement (CSP, Cryptographic Service Provider), soit sous la forme d'une collection brute d'octets.

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

BOOLEAN StrongNameGetPublicKey ( 
    [in]  LPCWSTR   szKeyContainer,
    [in]  BYTE      *pbKeyBlob,
    [in]  ULONG     cbKeyBlob,
    [out] BYTE      **ppbPublicKeyBlob,
    [out] ULONG     *pcbPublicKeyBlob
);

Paramètres

szKeyContainer
[in] Nom du conteneur de clé qui contient la paire de clés publique/privée. Si pbKeyBlob est null, szKeyContainer doit spécifier un conteneur valide dans le fournisseur de services de chiffrement. Dans ce cas, StrongNameGetPublicKey extrait la clé publique de la paire de clés stockée dans le conteneur.

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

Les clés doivent être des clés de signature RSA (Rivest-Shamir-Adleman) 1024 bits. Aucun autre type de clé n'est pris en charge à l'heure actuelle.
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 szKeyContainer est supposé contenir la paire de clés.
cbKeyBlob
[in] Taille en octets de pbKeyBlob.
ppbPublicKeyBlob
[out] BLOB de la clé publique retournée. Le paramètre ppbPublicKeyBlob est alloué par le Common Language Runtime et retourné à l'appelant. L'appelant doit libérer la mémoire en utilisant la fonction StrongNameFreeBuffer.
pcbPublicKeyBlob
[out] Taille du BLOB de la clé publique retournée.

Valeur de retour

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

Notes

La clé publique est contenue dans une structure PublicKeyBlob.

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