Fungsi EvtOpenPublisherMetadata (winevt.h)

Mendapatkan handel yang Anda gunakan untuk membaca metadata penyedia yang ditentukan.

Sintaks

EVT_HANDLE EvtOpenPublisherMetadata(
  [in, optional] EVT_HANDLE Session,
  [in]           LPCWSTR    PublisherId,
  [in, optional] LPCWSTR    LogFilePath,
  [in]           LCID       Locale,
  [in]           DWORD      Flags
);

Parameter

[in, optional] Session

Handel sesi jarak jauh yang dikembalikan fungsi EvtOpenSession . Atur ke NULL untuk mendapatkan metadata untuk penyedia di komputer lokal.

[in] PublisherId

Nama penyedia. Untuk menghitung nama penyedia yang terdaftar di komputer, panggil fungsi EvtOpenPublisherEnum .

[in, optional] LogFilePath

Jalur lengkap ke file log yang diarsipkan yang berisi peristiwa yang dicatat penyedia. File log yang diarsipkan juga berisi metadata penyedia. Gunakan parameter ini ketika penyedia tidak terdaftar di komputer lokal. Atur ke NULL saat membaca metadata dari penyedia terdaftar.

[in] Locale

Pengidentifikasi lokal untuk digunakan saat mengakses metadata yang dilokalkan dari penyedia. Untuk membuat pengidentifikasi lokal, gunakan makro MAKELCID. Atur ke 0 untuk menggunakan pengidentifikasi lokal utas panggilan.

[in] Flags

Dicadangkan. Harus nol.

Mengembalikan nilai

Jika berhasil, fungsi mengembalikan handel ke metadata penyedia; jika tidak, NULL. Jika NULL, panggil fungsi GetLastError untuk mendapatkan kode kesalahan.

Keterangan

Jika Anda menentukan file log yang diarsipkan, fungsi ini akan memeriksa metadata penyedia yang ditentukan dalam file log. Jika metadata penyedia tidak ditemukan dalam file log, fungsi akan mencari penyedia dalam daftar penyedia terdaftar di komputer lokal.

Untuk membaca metadata penyedia, panggil fungsi EvtGetPublisherMetadataProperty . Untuk menghitung peristiwa yang ditentukan penyedia, panggil fungsi EvtOpenEventMetadataEnum .

Anda harus memanggil fungsi EvtClose untuk menutup handel metadata setelah selesai.

Contoh

Untuk contoh yang memperlihatkan cara menggunakan fungsi ini, lihat Mendapatkan Metadata Penyedia.

Persyaratan

Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	winevt.h
Pustaka	Wevtapi.lib
DLL	Wevtapi.dll

Lihat juga

EvtGetPublisherMetadataProperty

EvtOpenEventMetadataEnum

EvtOpenPublisherEnum