Funzione InstallELAMCertificateInfo (sysinfoapi.h)

Articolo
03/02/2024

Installa le informazioni sul certificato specificate nel file di risorse, collegato al driver ELAM in fase di compilazione. Questa API viene usata dai fornitori anti-malware per avviare il servizio in modalità utente anti-malware come protetto. Per altre informazioni, vedere Protezione dei servizi antimalware.

Sintassi

BOOL InstallELAMCertificateInfo(
  [in] HANDLE ELAMFile
);

Parametri

[in] ELAMFile

Handle per un file di driver ELAM che contiene il file di risorse con le informazioni sul certificato. L'handle del file del driver ELAM deve essere aperto solo per l'accesso in lettura e non deve essere condiviso per l'accesso in scrittura.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

Se la funzione ha esito negativo, il valore restituito è FALSE. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

I fornitori di malware anti-malware possono usare questa API per registrare il servizio in modalità utente anti-malware che deve essere avviato come protetto. Si noti che l'handle di file fornito nel parametro hElamFile deve essere aperto solo per l'accesso in lettura e non deve essere condivisibile per l'accesso in scrittura.

Per altre informazioni, vedere Protezione dei servizi antimalware.

Esempio

Esempio di codice:

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1 [solo app desktop]
Server minimo supportato	Windows Server 2012 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	sysinfoapi.h (includere Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Condividi tramite