imageAddCertificate 函式 (imagehlp.h)

將憑證新增至指定的檔案。

語法

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

[in] FileHandle

要修改之圖像檔的句柄。必須開啟此句柄，才能存取FILE_READ_DATA和FILE_WRITE_DATA。

[in] Certificate

WIN_CERTIFICATE標頭和所有相關聯區段的指標。憑證標頭中的 Length 成員將用來判斷這個緩衝區的長度。

[out] Index

接收新加入憑證索引之變數的指標。

如果函式成功，則傳回值為 TRUE。

如果函式失敗，傳回值為 FALSE。若要擷取擴充的錯誤資訊，請呼叫 GetLastError。

憑證會新增至現有憑證清單的結尾，並指派索引。

所有 ImageHlp 函式，例如此函式都是單個線程。因此，從一個以上的線程呼叫此函式可能會導致非預期的行為或記憶體損毀。若要避免這種情況，您必須將所有並行呼叫從一個以上的線程同步至此函式。