AuthzInstallSecurityEventSource 函式 (authz.h)
AuthzInstallSecurityEventSource 函式會將指定的來源安裝為安全性事件來源。
語法
AUTHZAPI BOOL AuthzInstallSecurityEventSource(
[in] DWORD dwFlags,
[in] PAUTHZ_SOURCE_SCHEMA_REGISTRATION pRegistration
);
參數
[in] dwFlags
此參數保留供日後使用，且必須設定為零。
[in] pRegistration
AUTHZ_SOURCE_SCHEMA_REGISTRATION 結構的指標，其中包含要加入的安全性事件來源相關信息。
AUTHZ_SOURCE_SCHEMA_REGISTRATION 結構的成員會如下所示，在安全性記錄機碼中安裝安全性事件來源：
- szEventSourceName 成員會新增為下方的登錄機碼
HKEY_LOCAL_MACHINE SYSTEM CurrentControlSet Services EventLog Security
- szEventMessageFile 成員會新增為事件來源索引鍵下名為 EventMessageFile 之REG_SZ值中的數據。
- szEventAccessStringsFile 成員會新增為事件來源索引鍵下名為 ParameterMessageFile 之REG_SZ值中的數據。
- 如果登錄路徑不存在，則會建立它。
- 如果 szEventSourceXmlSchemaFile 成員不是 NULL，它會新增為事件來源索引鍵下名為 XmlSchemaFile 之REG_SZ值中的數據。 不使用這個值。
- szExecutableImagePath 成員可以設定為 NULL。
傳回值
如果函式成功，函式會傳回 TRUE。
如果函式失敗，則會傳回 FALSE。 如需擴充錯誤資訊，請呼叫 GetLastError。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | authz.h |
| 程式庫 | Authz.lib |
| Dll | Authz.dll |
| 可轉散發套件 | Windows XP 上的 Windows Server 2003 系統管理工具套件 |