Compartir a través de

StrongNameKeyGenEx (Función)

  • Artículo

Esta función puede usarse para generar un par de claves con una pública y otra privada, con el tamaño de clave que especifique, que pueda usar en nombres seguros.

Esta función está en desuso. En su lugar, use el método ICLRStrongName::StrongNameKeyGenEx.

Sintaxis

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

Parámetros

wszKeyContainer
[in] El valor de este parámetro se corresponde con el nombre del contenedor de claves que va a solicitar. El valor del parámetro wszKeyContainer debe establecerse como una cadena no vacía o como null para generar un nombre temporal.

dwFlags
[in] El valor de este parámetro sirve para especificar 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

Si la función se ejecuta correctamente, se devolverá el valor true; de lo contrario, se devolverá el valor false.

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á llamar a la función StrongNameFreeBuffer para liberar la memoria que se asignó durante el proceso.

Si la función StrongNameKeyGenEx no se ejecuta correctamente, llame a la función StrongNameErrorInfo para recuperar el último error que se haya generado.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: StrongName.h

Biblioteca: incluida como recurso en MsCorEE.dll

Versiones de .NET Framework: está disponible desde la versión 1.0

Consulte también