StrongNameGetPublicKey-Funktion

Artikel
09/02/2008

Aktualisiert: November 2007

Ruft den öffentlichen Schlüssel aus einem privaten/öffentlichen Schlüsselpaar ab. Das Schlüsselpaar kann entweder als Schlüsselcontainername in einem Kryptografiedienstanbieter (Cryptographic Service Provider, CSP) oder als eine Rohdatenauflistung von Bytes angegeben werden.

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 öffentliche/private Schlüsselpaar enthält. Wenn pbKeyBlob NULL ist, muss szKeyContainer einen gültigen Container im 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 BLOB (Binary Large Object) des Schlüssels enthalten ist.

Die Schlüssel müssen 1024-Bit-RSA-Signaturschlüssel (Rivest-Shamir-Adleman) sein. Momentan werden keine anderen Schlüsseltypen unterstützt.
pbKeyBlob
[in] Ein Zeiger auf das öffentliche/private Schlüsselpaar. Dieses Paar weist das von der Win32-CryptExportKey-Funktion erstellte Format auf. 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 für den öffentlichen Schlüssel. Der ppbPublicKeyBlob-Parameter wird von der Common Language Runtime zugeordnet und an den Aufrufer zurückgegeben. Der Aufrufer muss den Speicher mit der StrongNameFreeBuffer-Funktion freigeben.
pcbPublicKeyBlob
[out] Die Größe des zurückgegebenen BLOB für den öffentlichen Schlüssel.

Rückgabewert

Bei erfolgreichem Abschluss true, andernfalls false.

Hinweise

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 letzten generierten Fehler abzurufen.