Fonction InstallELAMCertificateInfo (sysinfoapi.h)

Article
03/04/2024

Installe les informations de certificat spécifiées dans le fichier de ressources, qui est lié au pilote ELAM au moment de la génération. Cette API est utilisée par les fournisseurs de logiciels anti-programme malveillant pour lancer le service en mode utilisateur du logiciel anti-programme malveillant comme protégé. Pour plus d’informations, consultez Protection des services anti-programme malveillant.

Syntaxe

BOOL InstallELAMCertificateInfo(
  [in] HANDLE ELAMFile
);

Paramètres

[in] ELAMFile

Handle d’un fichier de pilote ELAM qui contient le fichier de ressources avec les informations de certificat. Le handle du fichier de pilote ELAM doit être ouvert pour l’accès en lecture uniquement et ne doit pas être partagé pour l’accès en écriture.

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE.

Si la fonction échoue, la valeur de retour est FALSE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Les fournisseurs de logiciels anti-programmes malveillants peuvent utiliser cette API pour inscrire leur service en mode utilisateur anti-programme malveillant qui doit être lancé comme protégé. Notez que le handle de fichier fourni dans le paramètre hElamFile doit être ouvert pour l’accès en lecture uniquement et ne doit pas être partageable pour l’accès en écriture.

Pour plus d’informations, consultez Protection des services anti-programme malveillant.

Exemples

Exemple de code :

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8.1 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	sysinfoapi.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Partager via