Método ICLRStrongName::StrongNameKeyGenEx

Artigo
05/10/2023

Gera um novo par de chaves públicas/privadas com o tamanho da chave especificado para o uso 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 contêiner de chave solicitado. wszKeyContainer deve ser uma cadeia de caracteres não vazia ou nula para gerar um nome temporário.

dwFlags
[in] Um valor que especifica se a chave deve ser registrada. Os seguintes valores têm suporte:

0x00000000 – usado quando wszKeyContainer é nulo para gerar um nome de contêiner de chave temporário.
0x00000001 (SN_LEAVE_KEY) – especifica que a chave deve ser deixada registrada.

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

ppbKeyBlob
[out] O par de chaves pública/privada retornado.

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

Valor Retornado

S_OK se o método tiver sido concluído com êxito; caso contrário, um valor HRESULT que indica falha (consulte Valores HRESULT comuns para uma lista).

Comentários

Os .NET Framework versões 1.0 e 1.1 exigem um dwKeySize de 1024 bits para assinar um assembly com um nome forte; a versão 2.0 adiciona suporte para chaves de 2048 bits.

Depois que a chave for recuperada, você deverá chamar o método ICLRStrongName::StrongNameFreeBuffer para liberar a memória alocada.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: MetaHost.h

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

Versões do .NET Framework: disponíveis desde 4

Compartilhar via