Função StrongNameKeyGenEx

Artigo
05/10/2023

Gera um novo par de chaves públicas/privadas com o tamanho da chave especificada, para uma utilização forte do nome.

Esta função foi preterida. Em alternativa, utilize o método ICLRStrongName::StrongNameKeyGenEx .

Sintaxe

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

Parâmetros

wszKeyContainer
[in] O nome do contentor de chaves pedido. wszKeyContainer tem de ser uma cadeia não vazia ou nula para gerar um nome temporário.

dwFlags
[in] Especifica se pretende deixar a chave registada. São suportados os seguintes valores:

0x00000000 – utilizado quando wszKeyContainer é nulo para gerar um nome de contentor de chave temporária.
0x00000001 (SN_LEAVE_KEY) - Especifica que a chave deve ser deixada registada.

dwKeySize
[in] O tamanho pedido da chave, em bits.

ppbKeyBlob
[fora] O par de chaves públicas/privadas devolvido.

pcbKeyBlob
[fora] O tamanho, em bytes, de ppbKeyBlob.

Devolver Valor

true após a conclusão com êxito; caso contrário, false.

Observações

As .NET Framework versões 1.0 e 1.1 requerem um dwKeySize de 1024 bits para assinar uma assemblagem com um nome forte; a versão 2.0 adiciona suportes para chaves de 2048 bits.

Depois de a chave ser obtida, deve chamar a função StrongNameFreeBuffer para libertar a memória alocada.

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

Requisitos

Plataformas: Veja Requisitos de Sistema.

Cabeçalho: StrongName.h

Biblioteca: Incluído como um recurso no MsCorEE.dll

.NET Framework Versões: Disponível desde 1.0

Partilhar via