StrongNameKeyGenEx-Funktion

Artikel
06/02/2023

Erzeugt ein neues Paar aus öffentlichem und privatem Schlüssel mit der angegebenen Schlüsselgröße für die Verwendung starker Namen.

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

Syntax

BOOLEAN StrongNameKeyGenEx (  
    [in]  LPCWSTR   wszKeyContainer,  
    [in]  DWORD     dwFlags,  
    [in]  DWORD     dwKeySize,  
    [out] BYTE      **ppbKeyBlob,  
    [out] ULONG     *pcbKeyBlob  
);

Parameter

wszKeyContainer
[in] Der angeforderte Schlüsselcontainername. wszKeyContainer muss eine nicht leere Zeichenfolge oder NULL sein, um einen temporären Namen zu generieren.

dwFlags
[in] Gibt an, ob der Schlüssel registriert bleiben soll. Die folgenden Werte werden unterstützt:

0x00000000: wird verwendet, wenn wszKeyContainer NULL ist, um einen temporären Schlüsselcontainernamen zu generieren.
0x00000001 (SN_LEAVE_KEY): gibt an, dass der Schlüssel registriert bleiben soll.

dwKeySize
[in] Die angeforderte Größe des Schlüssels in Bits.

ppbKeyBlob
[out] Das zurückgegebene Paar aus öffentlichem und privatem Schlüssel.

pcbKeyBlob
[out] Die Größe von ppbKeyBlob in Bytes.

Rückgabewert

true nach erfolgreichem Abschluss; andernfalls false.

Bemerkungen

Die .NET Framework-Versionen 1.0 und 1.1 erfordern eine dwKeySize von 1.024 Bits, um eine Assembly mit einem starken Namen zu signieren. Version 2.0 fügt Unterstützung für 2.048-Bit-Schlüssel hinzu.

Nachdem der Schlüssel abgerufen wurde, müssen Sie die StrongNameFreeBuffer-Funktion aufrufen, um den zugeordneten Arbeitsspeicher freizugeben.

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