Compartir a través de

StrongNameKeyGenEx (Función)

  • Artículo

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

Esta función está desusada en .NET Framework versión 4. Use el método ICLRStrongName::StrongNameKeyGenEx en su lugar.

BOOLEAN 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. wszKeyContainer deben ser una cadena no vacía o null para generar un nombre temporal.

  • dwFlags
    [in] Especifica si se debe abandonar la clave registrada. Se admiten los siguientes valores:

    • 0x00000000: se utiliza cuando el valor de wszKeyContainer es null para generar un nombre de contenedor de claves temporal.

    • 0x00000001 (SN_LEAVE_KEY): especifica que la clave debería quedar registrada.

  • dwKeySize
    [in] Tamaño solicitado de la clave, en bytes.

  • ppbKeyBlob
    [out] Par de claves pública y privada devuelto.

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

Valor devuelto

Es true si se completa correctamente; en caso contrario, es false.

Comentarios

.NET Framework 1.0 y 1.1 requieren un valor de 1024 bits para dwKeySize con el fin de firmar los ensamblados con un nombre seguro; la versión 2.0 también admite claves de 2048 bits.

Una vez recuperada la clave, debe llamar a la función StrongNameFreeBuffer para liberar la memoria asignada.

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

Requisitos

Plataformas: vea Requisitos de sistema de .NET Framework.

Encabezado: StrongName.h

Biblioteca: Se incluye como recurso en MsCorEE.dll

Versiones de .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0

Vea también

Referencia

ICLRStrongName (Interfaz)

Otros recursos

ICLRStrongName::StrongNameKeyGenEx (Método)

ICLRStrongName::StrongNameKeyGen (Método)

Historial de cambios

Fecha

Historial

Motivo

Julio de 2010

Se agregó un vínculo agregado a la alternativa recomendada.

Mejora de la información.