InstallELAMCertificateInfo-Funktion (sysinfoapi.h)

  • Artikel

Installiert die Zertifikatinformationen, die in der Ressourcendatei angegeben sind, die zur Buildzeit mit dem ELAM-Treiber verknüpft ist. Diese API wird von Antischadsoftwareanbietern verwendet, um den Benutzermodusdienst der Antischadsoftware als geschützt zu starten. Weitere Informationen finden Sie unter Schutz von Antischadsoftwarediensten.

Syntax

BOOL InstallELAMCertificateInfo(
  [in] HANDLE ELAMFile
);

Parameter

[in] ELAMFile

Ein Handle für eine ELAM-Treiberdatei, die die Ressourcendatei mit den Zertifikatinformationen enthält. Das Handle für die ELAM-Treiberdatei muss nur für Lesezugriff geöffnet werden und darf nicht für den Schreibzugriff freigegeben werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Anbieter von Antischadsoftware können diese API verwenden, um ihren Antischadsoftware-Benutzermodusdienst zu registrieren, der als geschützt gestartet werden muss. Beachten Sie, dass das im hElamFile-Parameter angegebene Dateihandle nur für den Lesezugriff geöffnet werden muss und nicht für den Schreibzugriff freigegeben werden kann.

Weitere Informationen finden Sie unter Schutz von Antischadsoftwarediensten.

Beispiele

Codebeispiel:

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8.1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile sysinfoapi.h (windows.h einschließen)
Bibliothek Kernel32.lib
DLL Kernel32.dll