ICLRStrongName::StrongNameSignatureGeneration-Methode

Artikel
06/02/2023

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

Syntax

HRESULT 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 Name 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 (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 wszFilePathangegebenen Datei.

Wenn ppbSignatureBlob nicht NULL ist, teilt die Common Language Runtime Speicherplatz zu, in dem die Signatur zurückgegeben werden soll. Der Aufrufer muss den Arbeitsspeicher mithilfe der ICLRStrongName::StrongNameFreeBuffer-Methode freigeben.

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

Rückgabewert

S_OK, wenn die Methode erfolgreich abgeschlossen wurde; andernfalls ein HRESULT-Wert, der einen Fehler angibt (eine Liste finden Sie unter allgemeine HRESULT-Werte).

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.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: MetaHost.h

Bibliothek: Als Ressource in „MsCorEE.dll“ enthalten.

.NET Framework-Versionen: Seit Version 4 verfügbar.

Freigeben über