Método ICLRStrongName::StrongNameKeyGenEx

Artigo
05/10/2023

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

Sintaxe

HRESULT 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 chave pedida. wszKeyContainer tem de ser uma cadeia não vazia ou nula para gerar um nome temporário.

dwFlags
[in] Um valor que 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

S_OK se o método tiver sido concluído com êxito; caso contrário, um valor HRESULT que indica falhas (veja Valores HRESULT Comuns de uma lista).

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 o método ICLRStrongName::StrongNameFreeBuffer para libertar a memória alocada.

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: MetaHost.h

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

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

Partilhar via