Função StrongNameSignatureGenerationEx

Artigo
05/10/2023

Gera uma assinatura de nome forte para o assembly especificado, de acordo com os sinalizadores especificados.

Essa função foi preterida. Em vez dela, use o método ICLRStrongName::StrongNameSignatureGenerationEx.

Sintaxe

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] O caminho para o arquivo que contém o manifesto do assembly para o qual a assinatura de nome forte será gerada.

wszKeyContainer
[in] O nome do contêiner de chave que contém o par de chaves privadas/públicas.

Se pbKeyBlob for nulo, wszKeyContainer deverá especificar um contêiner válido dentro do CSP (provedor de serviços de criptografia). Nesse caso, o par de chaves armazenado no contêiner é usado para assinar o arquivo.

Se pbKeyBlob não for nulo, o par de chaves será considerado contido no BLOB (objeto binário grande) chave.

pbKeyBlob
[in] Um ponteiro para o par de chaves públicas/privadas. Esse par está no formato criado pela função CryptExportKey do Win32. Se pbKeyBlob for nulo, é considerado que o contêiner de chave especificado por wszKeyContainer contém o par de chaves.

cbKeyBlob
[in] O tamanho, em bytes, de pbKeyBlob.

ppbSignatureBlob
[out] Um ponteiro ao local para o qual o Common Language Runtime retorna a assinatura. Se ppbSignatureBlob for nulo, o runtime armazenará a assinatura no arquivo especificado por wszFilePath.

Se ppbSignatureBlob não for nulo, o Common Language Runtime alocará espaço no qual retornar a assinatura. O chamador precisa liberar esse espaço usando a função StrongNameFreeBuffer.

pcbSignatureBlob
[out] O tamanho, em bytes, da assinatura retornada.

dwFlags
[in] Um ou mais dos seguintes valores:

SN_SIGN_ALL_FILES (0x00000001) – Recompilar todos os hashes para módulos vinculados.
SN_TEST_SIGN (0x00000002) – Teste o sinal do assembly.

Valor Retornado

true na conclusão bem-sucedida, caso contrário, false.

Comentários

Especifique nulo no wszFilePath calcular o tamanho da assinatura sem criar a assinatura.

A assinatura pode ser armazenada diretamente no arquivo ou retornada ao chamador.

Se SN_SIGN_ALL_FILES for especificado, mas uma chave pública não estiver incluída (pbKeyBlob e wszFilePath são nulos), os hashes para módulos vinculados serão recalculados, mas o assembly não será assinado novamente.

Se SN_TEST_SIGN for especificado, o cabeçalho do Common Language Runtime não será modificado para indicar que o assembly está assinado com um nome forte.

Se a função StrongNameSignatureGenerationEx não for concluída com êxito, chame a função StrongNameErrorInfo para recuperar o último erro gerado.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: StrongName.h

Biblioteca: incluída como um recurso no MsCorEE.dll

Versões do .NET Framework: Disponíveis desde a versão 1.0

Compartilhar via