EvtOpenPublisherMetadata 函式 (winevt.h)
取得您用來讀取指定提供者中繼資料的控制碼。
語法
EVT_HANDLE EvtOpenPublisherMetadata(
[in, optional] EVT_HANDLE Session,
[in] LPCWSTR PublisherId,
[in, optional] LPCWSTR LogFilePath,
[in] LCID Locale,
[in] DWORD Flags
);
參數
[in, optional] Session
EvtOpenSession 函式傳回的遠端會話控制碼。 設定為 Null ，以取得本機電腦上的提供者中繼資料。
[in] PublisherId
提供者的名稱。 若要列舉電腦上註冊的提供者名稱，請呼叫 EvtOpenPublisherEnum 函式。
[in, optional] LogFilePath
封存記錄檔的完整路徑，其中包含提供者記錄的事件。 封存的記錄檔也包含提供者的中繼資料。 當提供者未在本機電腦上註冊時，請使用此參數。 從已註冊的提供者讀取中繼資料時，設定為 Null 。
[in] Locale
從提供者存取當地語系化中繼資料時要使用的地區設定識別碼。 若要建立地區設定識別碼，請使用 MAKELCID 宏。 設定為 0，以使用呼叫執行緒的地區設定識別碼。
[in] Flags
保留的。 必須為零。
傳回值
如果成功，函式會傳回提供者中繼資料的控制碼;否則為 Null。 如果 為 Null，請呼叫 GetLastError 函式以取得錯誤碼。
備註
如果您指定封存的記錄檔，此函式會在記錄檔中檢查指定的提供者中繼資料。 如果在記錄檔中找不到提供者的中繼資料，函式會在本機電腦上的已註冊提供者清單中搜尋提供者。
若要讀取提供者的中繼資料，請呼叫 EvtGetPublisherMetadataProperty 函式 。 若要列舉提供者定義的事件，請呼叫 EvtOpenEventMetadataEnum 函式。
您必須呼叫 EvtClose 函式，才能在完成時關閉中繼資料控制碼。
範例
如需示範如何使用此函式的範例，請參閱 取得提供者的中繼資料。
規格需求
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | winevt.h |
| 程式庫 | Wevtapi.lib |
| Dll | Wevtapi.dll |