Função CertAddEncodedCertificateToSystemStoreA (wincrypt.h)

Artigo
11/20/2024

A função CertAddEncodedCertificateToSystemStore abre o repositório do sistema especificado e adiciona o certificado codificado a ele.

Sintaxe

BOOL CertAddEncodedCertificateToSystemStoreA(
  [in] LPCSTR     szCertStoreName,
  [in] const BYTE *pbCertEncoded,
  [in] DWORD      cbCertEncoded
);

Parâmetros

[in] szCertStoreName

Uma cadeia de caracteres terminada em nulo que contém o nome do repositório do sistema para o certificado codificado.

[in] pbCertEncoded

Um ponteiro para um buffer que contém o certificado codificado a ser adicionado.

[in] cbCertEncoded

O tamanho, em bytes, do buffer pbCertEncoded.

Valor de retorno

Se a função for bem-sucedida, o valor retornado será VERDADEIRO.

Se a função falhar, o valor retornado será false. CertAddEncodedCertificateToSystemStore depende das funções listadas nas observações a seguir para tratamento de erros. Consulte esses tópicos de função para seus respectivos comportamentos de tratamento de erros. Para obter informações de erro estendidas, chame GetLastError.

Observações

Internamente, CertAddEncodedCertificateToSystemStore chamadas CertOpenSystemStore e CertAddEncodedCertificateToStore com os seguintes parâmetros.

Parâmetro CertOpenSystemStore	Valor
szSubsystemProtocol	szCertStoreName

Se CertAddEncodedCertificateToSystemStore obter um identificador para o repositório do sistema especificado, ele chamará CertCloseStore fechar o identificador antes de retornar.

Parâmetro de CertAddEncodedCertificateToStore	Valor
dwCertEncodingType	X509_ASN_ENCODING
dwAddDisposition	CERT_STORE_ADD_USE_EXISTING
ppCertContext	NULL

Nota

O cabeçalho wincrypt.h define CertAddEncodedCertificateToSystemStore como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	wincrypt.h
biblioteca	Crypt32.lib
de DLL	Crypt32.dll

Partilhar via