EvtNextChannelPath-Funktion (winevt.h)

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

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

Weitere Informationen

EvtOpenChannelEnum