Функция InstallELAMCertificateInfo (sysinfoapi.h)

  • Статья

Устанавливает сведения о сертификате, указанные в файле ресурсов, который связан с драйвером ELAM во время сборки. Этот API используется поставщиками защиты от вредоносных программ для запуска службы пользовательского режима защиты от вредоносных программ в качестве защищенной. Дополнительные сведения см. в разделе Защита служб защиты от вредоносных программ.

Синтаксис

BOOL InstallELAMCertificateInfo(
  [in] HANDLE ELAMFile
);

Параметры

[in] ELAMFile

Дескриптор файла драйвера ELAM, который содержит файл ресурсов со сведениями о сертификате. Дескриптор файла драйвера ELAM должен быть открыт только для чтения и не должен быть общим для доступа на запись.

Возвращаемое значение

Если функция выполнена успешно, возвращается значение TRUE.

Если функция завершается сбоем, возвращается значение FALSE. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Поставщики антивредоносных программ могут использовать этот API для регистрации службы защиты от вредоносных программ в пользовательском режиме, которая должна быть запущена как защищенная. Обратите внимание, что дескриптор файла, указанный в параметре hElamFile , должен быть открыт только для чтения и не должен быть общим для доступа на запись.

Дополнительные сведения см. в разделе Защита служб защиты от вредоносных программ.

Примеры

Пример кода:

HANDLE FileHandle = NULL;

FileHandle = CreateFile(<Insert Elam driver file name>,
                        FILE_READ_DATA,
                        FILE_SHARE_READ,
                        NULL,
                        OPEN_EXISTING,
                        FILE_ATTRIBUTE_NORMAL,
                        NULL
                        );

if (InstallElamCertificateInfo(FileHandle) == FALSE)
{
    Result = GetLastError();
    goto exitFunc;
}

Требования

Требование Значение
Минимальная версия клиента Windows 8.1 [только классические приложения]
Минимальная версия сервера Windows Server 2012 R2 [только классические приложения]
Целевая платформа Windows
Header sysinfoapi.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll