EvtGetEventMetadataProperty-Funktion (winevt.h)

Artikel
03/06/2024

Ruft die angegebene Ereignismetadateneigenschaft ab.

Syntax

BOOL EvtGetEventMetadataProperty(
  [in]  EVT_HANDLE                     EventMetadata,
  [in]  EVT_EVENT_METADATA_PROPERTY_ID PropertyId,
  [in]  DWORD                          Flags,
  [in]  DWORD                          EventMetadataPropertyBufferSize,
  [in]  PEVT_VARIANT                   EventMetadataPropertyBuffer,
  [out] PDWORD                         EventMetadataPropertyBufferUsed
);

Parameter

[in] EventMetadata

Ein Handle für die Ereignismetadaten, die von der EvtNextEventMetadata-Funktion zurückgegeben werden .

[in] PropertyId

Der Bezeichner der abzurufenden Metadateneigenschaft. Eine Liste der Eigenschaftenbezeichner finden Sie in der EVT_EVENT_METADATA_PROPERTY_ID-Enumeration .

[in] Flags

Reserviert. Muss Null sein.

[in] EventMetadataPropertyBufferSize

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

[in] EventMetadataPropertyBuffer

Ein vom Aufrufer zugewiesener Puffer, der die Metadateneigenschaft 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] EventMetadataPropertyBufferUsed

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

EvtGetPublisherMetadataProperty

EvtNextEventMetadata

Freigeben über