EvtGetChannelConfigProperty-Funktion (winevt.h)

Artikel
03/04/2024

Ruft die angegebene Kanalkonfigurationseigenschaft ab.

Syntax

BOOL EvtGetChannelConfigProperty(
  [in]  EVT_HANDLE                     ChannelConfig,
  [in]  EVT_CHANNEL_CONFIG_PROPERTY_ID PropertyId,
  [in]  DWORD                          Flags,
  [in]  DWORD                          PropertyValueBufferSize,
  [in]  PEVT_VARIANT                   PropertyValueBuffer,
  [out] PDWORD                         PropertyValueBufferUsed
);

Parameter

[in] ChannelConfig

Ein Handle für die Konfigurationseigenschaften des Kanals, die von der EvtOpenChannelConfig-Funktion zurückgegeben werden.

[in] PropertyId

Der Bezeichner der abzurufenden Kanaleigenschaft. Eine Liste der Eigenschaftenbezeichner finden Sie in der EVT_CHANNEL_CONFIG_PROPERTY_ID-Enumeration .

[in] Flags

Reserviert. Muss Null sein.

[in] PropertyValueBufferSize

Die Größe des PropertyValueBuffer-Puffers in Bytes.

[in] PropertyValueBuffer

Ein vom Aufrufer zugewiesener Puffer, der die Konfigurationseigenschaft empfängt. Der Puffer enthält ein EVT_VARIANT-Objekt . Sie können diesen Parameter auf NULL festlegen, um die erforderliche Puffergröße zu bestimmen.

[out] PropertyValueBufferUsed

Die Größe des vom Aufrufer zugewiesenen Puffers in Bytes, 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.

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

EvtOpenChannelConfig

Freigeben über