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 系統管理工具套件

另請參閱

AUTHZ_SOURCE_SCHEMA_REGISTRATION

AuthzUninstallSecurityEventSource