EvtNextChannelPath-Funktion (winevt.h)

Artikel
03/06/2024

Ruft einen Kanalnamen aus dem Enumerator ab.

Syntax

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

Parameter

[in] ChannelEnum

Ein Handle für den Enumerator, den die EvtOpenChannelEnum-Funktion zurückgibt.

[in] ChannelPathBufferSize

Die Größe des ChannelPathBuffer-Puffers in Zeichen.

[in] ChannelPathBuffer

Ein vom Aufrufer zugeordneter Puffer, der den Namen des Kanals empfängt. Sie können diesen Parameter auf NULL festlegen, um die erforderliche Puffergröße zu bestimmen.

[out] ChannelPathBufferUsed

Die Größe des vom Aufrufer zugewiesenen Puffers in Zeichen, den die Funktion verwendet hat, oder die erforderliche Puffergröße, wenn die Funktion mit ERROR_INSUFFICIENT_BUFFER fehlschlägt.

Rückgabewert

Rückgabecode/-wert	BESCHREIBUNG
TRUE	Die Funktion wurde erfolgreich ausgeführt.
FALSE	Fehler bei der Funktion. Rufen Sie die GetLastError-Funktion auf, um den Fehlercode abzurufen.

Hinweise

Rufen Sie diese Funktion in einer Schleife auf, bis die Funktion FALSE zurückgibt und der Fehlercode ERROR_NO_MORE_ITEMS ist.

Beispiele

Ein Beispiel zur Verwendung dieser Funktion finden Sie unter Abrufen und Festlegen der Konfigurationseigenschaften eines Kanals.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winevt.h
Bibliothek	Wevtapi.lib
DLL	Wevtapi.dll

Weitere Informationen

EvtOpenChannelEnum

Freigeben über