Compartilhar via


Função ImageAddCertificate (imagehlp.h)

Adiciona um certificado ao arquivo especificado.

Sintaxe

BOOL IMAGEAPI ImageAddCertificate(
  [in]  HANDLE            FileHandle,
  [in]  LPWIN_CERTIFICATE Certificate,
  [out] PDWORD            Index
);

Parâmetros

[in] FileHandle

Um identificador para o arquivo de imagem a ser modificado. Esse identificador deve ser aberto para acesso FILE_READ_DATA e FILE_WRITE_DATA.

[in] Certificate

Um ponteiro para um cabeçalho WIN_CERTIFICATE e todas as seções associadas. O membro Length no cabeçalho do certificado será usado para determinar o comprimento desse buffer.

[out] Index

Um ponteiro para uma variável que recebe o índice do certificado recém-adicionado.

Retornar valor

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

Se a função falhar, o valor retornado será FALSE. Para recuperar informações de erro estendidas, chame GetLastError.

Comentários

O certificado é adicionado no final da lista existente de certificados e recebe um índice.

Todas as funções ImageHlp, como esta, são threaded único. Portanto, chamadas de mais de um thread para essa função provavelmente resultarão em comportamento inesperado ou corrupção de memória. Para evitar isso, você deve sincronizar todas as chamadas simultâneas de mais de um thread para essa função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho imagehlp.h
Biblioteca Imagehlp.lib
DLL Imagehlp.dll

Confira também

Funções ImageHlp

ImageRemoveCertificate