Fungsi EvtNextChannelPath (winevt.h)

  • Artikel
  • 2 menit untuk membaca

Mendapatkan nama saluran dari enumerator.

Sintaks

BOOL EvtNextChannelPath(
  [in]  EVT_HANDLE ChannelEnum,
  [in]  DWORD      ChannelPathBufferSize,
  [in]  LPWSTR     ChannelPathBuffer,
  [out] PDWORD     ChannelPathBufferUsed
);

Parameter

[in] ChannelEnum

Handel ke enumerator yang dikembalikan fungsi EvtOpenChannelEnum .

[in] ChannelPathBufferSize

Ukuran buffer ChannelPathBuffer , dalam karakter.

[in] ChannelPathBuffer

Buffer yang dialokasikan penelepon yang akan menerima nama saluran. Anda dapat mengatur parameter ini ke NULL untuk menentukan ukuran buffer yang diperlukan.

[out] ChannelPathBufferUsed

Ukuran, dalam karakter, dari buffer yang dialokasikan pemanggil yang digunakan fungsi atau ukuran buffer yang diperlukan jika fungsi gagal dengan ERROR_INSUFFICIENT_BUFFER.

Mengembalikan nilai

Mengembalikan kode/nilai Deskripsi
TRUE
 Fungsi berhasil.
FALSE
 Fungsi gagal. Untuk mendapatkan kode kesalahan, panggil fungsi GetLastError .

Keterangan

Panggil fungsi ini dalam perulangan hingga fungsi mengembalikan FALSE dan kode kesalahan ERROR_NO_MORE_ITEMS.

Contoh

Untuk contoh yang menunjukkan cara menggunakan fungsi ini, lihat Mendapatkan dan Mengatur Properti Konfigurasi Saluran.

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

EvtOpenChannelEnum