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