Функция 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, такие как эта, являются однопоточными. Таким образом, вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header imagehlp.h
Библиотека Imagehlp.lib
DLL Imagehlp.dll

См. также раздел

Функции ImageHlp

ImageRemoveCertificate