ICLRStrongName::StrongNameKeyGenEx (Método)

Artículo
05/10/2023

Genera un par de claves pública y privada con el tamaño de clave especificado para su uso en nombres seguros.

Sintaxis

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

Parámetros

wszKeyContainer
[in] Nombre del contenedor de claves solicitado. El valor de wszKeyContainer debe establecerse como una cadena no vacía o como null para generar un nombre temporal.

dwFlags
[in] Valor que especifica si la clave permanecerá registrada. Se admiten los valores siguientes:

0x00000000: si el valor del parámetro wszKeyContainer es null, este valor se usa para generar un nombre de contenedor de claves temporal.
0x00000001 (SN_LEAVE_KEY): este valor se usa para especificar que la clave debe permanecer registrada.

dwKeySize
[in] El valor de este parámetro se corresponde con el tamaño que se va a solicitar para la clave, que se mide en bits.

ppbKeyBlob
[out] El valor de este parámetro se corresponde con el par de claves pública y privada que se devolverá.

pcbKeyBlob
[out] Tamaño en bytes de ppbKeyBlob.

Valor devuelto

Se devolverá el valor S_OK si el método se completa correctamente; de lo contrario, se devolverá un valor HRESULT que se corresponderá con un error (vea Valores HRESULT comunes para obtener una lista).

Comentarios

Para firmar un ensamblado con un nombre seguro en las versiones 1.0 y 1.1 de .NET Framework, se requerirá que el parámetro dwKeySize tenga un valor de 1024 bits; en la versión 2.0 se agrega compatibilidad con claves de 2048 bits.

Una vez que se recupere la clave, debería llamar al método ICLRStrongName::StrongNameFreeBuffer para liberar la memoria asignada.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: MetaHost.h

Biblioteca: incluida como recurso en MSCorEE.dll

Versiones de .NET Framework: disponible a partir de la versión 4

Compartir a través de