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;
}
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8.1 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2012 R2 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | sysinfoapi.h (包含 Windows.h) |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |