Função StrongNameGetPublicKey

Artigo
05/10/2023

Obtém a chave pública de um par de chaves pública/privada. O par de chaves pode ser fornecido como um nome de contêiner de chave em um CSP (provedor de serviços criptográficos) ou como uma coleção bruta de bytes.

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

Sintaxe

BOOLEAN StrongNameGetPublicKey (
    [in]  LPCWSTR   szKeyContainer,  
    [in]  BYTE      *pbKeyBlob,  
    [in]  ULONG     cbKeyBlob,  
    [out] BYTE      **ppbPublicKeyBlob,  
    [out] ULONG     *pcbPublicKeyBlob  
);

Parâmetros

szKeyContainer
[in] O nome do contêiner de chave que contém o par de chaves privadas/públicas. Se pbKeyBlob for nulo, szKeyContainer deverá especificar um contêiner válido dentro do CSP. Nesse caso, StrongNameGetPublicKey extrai a chave pública do par de chaves armazenado no contêiner.

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

As chaves devem ser chaves de assinatura RSA (Rivest-Shamir-Adleman) de 1024 bits. Não há suporte para nenhum outro tipo de chave no momento.

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 szKeyContainer contém o par de chaves.

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

ppbPublicKeyBlob
[out] O BLOB da chave pública retornada. O parâmetro ppbPublicKeyBlob é alocado pelo Common Language Runtime e retornado ao chamador. O chamador deve liberar a memória usando a função StrongNameFreeBuffer.

pcbPublicKeyBlob
[out] O tamaho do BLOB da chave pública retornada.

Valor Retornado

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

Comentários

A chave pública está contida em uma estrutura PublicKeyBlob.

Se a função StrongNameGetPublicKey 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