InstallELAMCertificateInfo 函式 (sysinfoapi.h)

安裝資源檔中指定的憑證資訊，這會在建置階段連結至 ELAM 驅動程式。 反惡意代碼廠商會使用此 API，將反惡意程式碼軟體的使用者模式服務啟動為受保護。 如需詳細資訊，請參閱 保護反惡意代碼服務。

語法

BOOL InstallELAMCertificateInfo(
  [in] HANDLE ELAMFile
);

參數

[in] ELAMFile

ELAM 驅動程式檔案的句柄，其中包含具有憑證資訊的資源檔。 必須開啟 ELAM 驅動程式檔案的句柄，才能進行唯讀存取，而且不得共用以取得寫入許可權。

傳回值

如果函式成功，則傳回值為TRUE。

如果函式失敗，傳回值為 FALSE。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

反惡意代碼廠商可以使用此 API 來註冊其需要以受保護方式啟動的反惡意代碼使用者模式服務。 請注意， hElamFile 參數中提供的檔案句柄必須針對唯讀許可權開啟，而且不能共用寫入許可權。

如需詳細資訊，請參閱 保護反惡意代碼服務。

範例

程式碼範例：

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

規格需求