Freigeben über


StrongNameSignatureGeneration-Funktion

Aktualisiert: November 2007

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

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 zu der Datei, die das Manifest der Assembly enthält, für die die Signatur mit starkem Namen generiert wird.

  • wszKeyContainer
    [in] Der Name des Schlüsselcontainers, der das öffentliche/private Schlüsselpaar enthält.

    Wenn pbKeyBlob NULL ist, muss wszKeyContainer einen gültigen Container im Kryptografiedienstanbieter (Cryptographic Service Provider, CSP) angeben. In diesem Fall wird zum Signieren der Datei das im Container gespeicherte Schlüsselpaar verwendet.

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

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

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

    Wenn ppbSignatureBlob einen Wert ungleich NULL hat, weist die Common Language Runtime Speicherplatz für die Rückgabe der Signatur zu. Der Aufrufer muss diesen Speicherplatz mit der StrongNameFreeBuffer-Funktion freigeben.

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

Rückgabewert

Bei erfolgreichem Abschluss true, andernfalls false.

Hinweise

Geben Sie für wszFilePath NULL 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 letzten generierten Fehler abzurufen.

Anforderungen

Plattformen: siehe Systemanforderungen für .NET Framework.

Header: StrongName.h

Bibliothek: als Ressource in MsCorEE.dll enthalten

.NET Framework-Versionen: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0

Siehe auch

Referenz

StrongNameSignatureGenerationEx-Funktion

Weitere Ressourcen

Starke Namen – Globale statistische Funktionen