Compartir a través de


StrongNameSignatureGenerationEx (Función)

Genera una firma de nombre seguro para el ensamblado especificado, según las marcas indicadas.

Esta función está en desuso. Use en su lugar el método ICLRStrongName::StrongNameSignatureGenerationEx.

Sintaxis

BOOLEAN StrongNameSignatureGenerationEx (  
    [in]  LPCWSTR   wszFilePath,  
    [in]  LPCWSTR   wszKeyContainer,  
    [in]  BYTE      *pbKeyBlob,  
    [in]  ULONG     cbKeyBlob,  
    [out] BYTE      **ppbSignatureBlob,  
    [out] ULONG     *pcbSignatureBlob,  
    [in]  DWORD     dwFlags  
);  

Parámetros

wszFilePath
[in] Ruta de acceso al archivo que contiene el manifiesto del ensamblado para el que se generará la firma de nombre seguro.

wszKeyContainer
[in] Nombre del contenedor de claves que contiene el nombre del par de claves pública y privada.

Si pbKeyBlob es null, wszKeyContainer debe especificar un contenedor válido dentro del proveedor de servicios criptográficos (CSP). En este caso, se usa el par de claves almacenado en el contenedor para firmar el archivo.

Si pbKeyBlob no es null, se supone que el par de claves está incluido en el objeto binario grande (BLOB) de clave.

pbKeyBlob
[in] Puntero al par de claves pública y privada. Este par tiene el formato que crea la función CryptExportKey de Win32. Si pbKeyBlob es null, se supone que el contenedor de claves especificado por wszKeyContainer contiene el par de claves.

cbKeyBlob
[in] Tamaño en bytes de pbKeyBlob.

ppbSignatureBlob
[out] Puntero a la ubicación en la que Common Language Runtime devuelve la firma. Si ppbSignatureBlob es null, el runtime almacena la firma en el archivo que especifica wszFilePath.

Si ppbSignatureBlob no es null, Common Language Runtime asigna espacio en el que se devolverá la firma. El llamador debe liberar este espacio mediante la función StrongNameFreeBuffer.

pcbSignatureBlob
[out] Tamaño en bytes de la firma devuelta.

dwFlags
[in] Uno o varios de los valores siguientes:

  • SN_SIGN_ALL_FILES (0x00000001): vuelva a calcular todos los hashes de los módulos vinculados.

  • SN_TEST_SIGN (0x00000002): firma de generación de prueba al ensamblado.

Valor devuelto

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

Comentarios

Especifique null para que wszFilePath calcule el tamaño de la firma sin crearla.

La firma se puede almacenar directamente en el archivo o devolverla al autor de la llamada.

Si SN_SIGN_ALL_FILES se especifica pero no se incluye una clave pública (pbKeyBlob y wszFilePath son null), se vuelven a calcular los hash de los módulos vinculados, pero el ensamblado no se vuelve a firmar.

Si SN_TEST_SIGN se especifica , el encabezado de Common Language Runtime no se modifica para indicar que el ensamblado está firmado con un nombre seguro.

Si la función StrongNameSignatureGenerationEx no se completa correctamente, llame a la función StrongNameErrorInfo para recuperar el último error 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