StrongNameGetPublicKey-Funktion

Artikel
06/02/2023

Ruft den öffentlichen Schlüssel aus einem privaten/öffentlichen Schlüsselpaar ab. Das Schlüsselpaar kann entweder als Schlüsselcontainername innerhalb eines Kryptografiedienstanbieters (CSP) oder als unformatierte Sammlung von Bytes angegeben werden.

Diese Funktion ist veraltet. Verwenden Sie stattdessen die ICLRStrongName::StrongNameGetPublicKey-Methode.

Syntax

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

Parameter

szKeyContainer
[in] Der Name des Schlüsselcontainers, der das Paar aus öffentlichem und privatem Schlüssel enthält. Wenn pbKeyBlob NULL ist, muss szKeyContainer einen gültigen Container innerhalb des CSP angeben. In diesem Fall extrahiert StrongNameGetPublicKey den öffentlichen Schlüssel aus dem im Container gespeicherten Schlüsselpaar.

Wenn pbKeyBlob nicht NULL ist, wird davon ausgegangen, dass das Schlüsselpaar im Schlüsselblob (Binary Large Object) enthalten ist.

Die Schlüssel müssen 1024-Bit-RSA-Signaturschlüssel (Rivest-Shamir-Adleman) sein. Derzeit werden keine anderen Schlüsseltypen unterstützt.

pbKeyBlob
[in] Ein Zeiger auf das Paar aus öffentlichem und privatem Schlüssel. Dieses Paar hat das Format, das von der Win32-Funktion CryptExportKey erstellt wurde. Wenn pbKeyBlob NULL ist, wird davon ausgegangen, dass der von szKeyContainer angegebene Schlüsselcontainer das Schlüsselpaar enthält.

cbKeyBlob
[in] Die Größe von pbKeyBlob in Bytes.

ppbPublicKeyBlob
[out] Das zurückgegebene Blob mit dem öffentlichen Schlüssel. Der ppbPublicKeyBlob-Parameter wird von der Common Language Runtime zugeordnet und an den Aufrufer zurückgegeben. Der Aufrufer muss den Arbeitsspeicher mit der StrongNameFreeBuffer-Funktion freigeben.

pcbPublicKeyBlob
[out] Die Größe des zurückgegebenen Blob mit dem öffentlichen Schlüssel.

Rückgabewert

true nach erfolgreichem Abschluss; andernfalls false.

Bemerkungen

Der öffentliche Schlüssel ist in einer PublicKeyBlob-Struktur enthalten.

Wenn die StrongNameGetPublicKey-Funktion nicht erfolgreich abgeschlossen wird, rufen Sie die StrongNameErrorInfo-Funktion auf, um den zuletzt generierten Fehler abzurufen.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: StrongName.h

Bibliothek: als Ressource in „MsCorEE.dll“ enthalten

.NET Framework-Versionen: seit Version 1.0 verfügbar

Freigeben über