Função InstallELAMCertificateInfo (sysinfoapi.h)

Instala as informações de certificado especificadas no arquivo de recurso, que está vinculado ao driver ELAM no momento da compilação. Essa API é usada por fornecedores antimalware para iniciar o serviço de modo de usuário do software antimalware como protegido. Para obter mais informações, consulte Protegendo serviços antimalware.

Sintaxe

BOOL InstallELAMCertificateInfo(
  [in] HANDLE ELAMFile
);

Parâmetros

[in] ELAMFile

Um identificador para um arquivo de driver ELAM que contém o arquivo de recurso com as informações de certificado. O identificador para o arquivo de driver ELAM deve ser aberto somente para acesso de leitura e não deve ser compartilhado para acesso de gravação.

Retornar valor

Se a função for bem-sucedida, o valor retornado será TRUE.

Se a função falhar, o valor retornado será FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Os fornecedores antimalware podem usar essa API para registrar seu serviço de modo de usuário antimalware que precisa ser iniciado como protegido. Observe que o identificador de arquivo fornecido no parâmetro hElamFile deve ser aberto somente para acesso de leitura e não deve ser compartilhável para acesso de gravação.

Para obter mais informações, consulte Protegendo serviços antimalware.

Exemplos

Exemplo 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	Valor
Cliente mínimo com suporte	Windows 8.1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	sysinfoapi.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll