StrongNameSignatureGeneration-Funktion

Artikel
06/12/2023

Generiert eine Signatur mit starkem Namen für die angegebene Assembly.

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

Syntax

BOOLEAN StrongNameSignatureGeneration (
    [in]  LPCWSTR   wszFilePath,  
    [in]  LPCWSTR   wszKeyContainer,  
    [in]  BYTE      *pbKeyBlob,  
    [in]  ULONG     cbKeyBlob,  
    [out] BYTE      **ppbSignatureBlob,  
    [out] ULONG     *pcbSignatureBlob  
);

Parameter

wszFilePath
[in] Der Pfad zur Datei mit dem Manifest der Assembly, für die die Signatur mit starkem Namen generiert wird.

wszKeyContainer
[in] Der Name des Schlüsselcontainers, der das Paar aus öffentlichem und privatem Schlüssel enthält.

Wenn pbKeyBlob NULL ist, muss wszKeyContainer einen gültigen Container innerhalb des Kryptografiedienstanbieters (Cryptographic Service Provider, CSP) angeben. In diesem Fall wird das im Container gespeicherte Schlüsselpaar verwendet, um die Datei zu signieren.

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 wszKeyContainer angegebene Schlüsselcontainer das Schlüsselpaar enthält.

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

ppbSignatureBlob
[out] Ein Zeiger auf den Speicherort, an den die Common Language Runtime die Signatur zurückgibt. Wenn ppbSignatureBlob NULL ist, speichert die Runtime die Signatur in der von wszFilePath angegebenen Datei.

Wenn ppbSignatureBlob nicht NULL ist, ordnet die Common Language Runtime Speicherplatz zu, an dem die Signatur zurückgegeben werden soll. Der Aufrufer muss diesen Speicherplatz mit der StrongNameFreeBuffer-Funktion freigeben.

pcbSignatureBlob
[out] Die Größe der zurückgegebenen Signatur in Bytes.

Rückgabewert

true nach erfolgreichem Abschluss; andernfalls false.

Bemerkungen

Geben Sie NULL für wszFilePath an, um die Größe der Signatur zu berechnen, ohne die Signatur zu erstellen.

Die Signatur kann entweder direkt in der Datei gespeichert oder an den Aufrufer zurückgegeben werden.

Wenn die StrongNameSignatureGeneration-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