Share via

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
标头 sysinfoapi.h (包括 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll