Funzione ImageAddCertificate (imagehlp.h)

Aggiunge un certificato al file specificato.

Sintassi

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

Parametri

[in] FileHandle

Handle per il file di immagine da modificare. Questo handle deve essere aperto per l'accesso FILE_READ_DATA e FILE_WRITE_DATA.

[in] Certificate

Puntatore a un'intestazione WIN_CERTIFICATE e a tutte le sezioni associate. Il membro Length nell'intestazione del certificato verrà utilizzato per determinare la lunghezza del buffer.

[out] Index

Puntatore a una variabile che riceve l'indice del certificato appena aggiunto.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

Se la funzione ha esito negativo, il valore restituito è FALSE. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Commenti

Il certificato viene aggiunto alla fine dell'elenco esistente di certificati e viene assegnato un indice.

Tutte le funzioni ImageHlp, ad esempio questa, sono a thread singolo. Di conseguenza, le chiamate da più thread a questa funzione genereranno un comportamento imprevisto o un danneggiamento della memoria. Per evitare questo problema, è necessario sincronizzare tutte le chiamate simultanee da più thread a questa funzione.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione imagehlp.h
Libreria Imagehlp.lib
DLL Imagehlp.dll

Vedi anche

Funzioni ImageHlp

ImageRemoveCertificate