Función InstallELAMCertificateInfo (sysinfoapi.h)

Instala la información del certificado especificada en el archivo de recursos, que está vinculada al controlador ELAM en tiempo de compilación. Los proveedores antimalware usan esta API para iniciar el servicio en modo de usuario del software antimalware como protegido. Para obtener más información, consulte Protección de los servicios antimalware.

Sintaxis

BOOL InstallELAMCertificateInfo(
  [in] HANDLE ELAMFile
);

Parámetros

[in] ELAMFile

Identificador de un archivo de controlador ELAM que contiene el archivo de recursos con la información del certificado. El identificador del archivo del controlador ELAM debe abrirse solo para acceso de lectura y no debe compartirse para el acceso de escritura.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es TRUE.

Si se produce un error en la función, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Los proveedores de antimalware pueden usar esta API para registrar su servicio de modo usuario antimalware que debe iniciarse como protegido. Tenga en cuenta que el identificador de archivo proporcionado en el parámetro hElamFile debe abrirse solo para el acceso de lectura y no debe compartirse para el acceso de escritura.

Para obtener más información, consulte Protección de los servicios antimalware.

Ejemplos

Ejemplo de código:

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;
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8.1 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	sysinfoapi.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll