EvtGetPublisherMetadataProperty-Funktion (winevt.h)

Artikel
08/27/2023

Ruft die angegebene Metadateneigenschaft des Anbieters ab.

Syntax

BOOL EvtGetPublisherMetadataProperty(
  [in]  EVT_HANDLE                         PublisherMetadata,
  [in]  EVT_PUBLISHER_METADATA_PROPERTY_ID PropertyId,
  [in]  DWORD                              Flags,
  [in]  DWORD                              PublisherMetadataPropertyBufferSize,
  [in]  PEVT_VARIANT                       PublisherMetadataPropertyBuffer,
  [out] PDWORD                             PublisherMetadataPropertyBufferUsed
);

Parameter

[in] PublisherMetadata

Ein Handle für die Metadaten, die von der EvtOpenPublisherMetadata-Funktion zurückgegeben werden .

[in] PropertyId

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

[in] Flags

Reserviert. Muss Null sein.

[in] PublisherMetadataPropertyBufferSize

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

[in] PublisherMetadataPropertyBuffer

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] PublisherMetadataPropertyBufferUsed

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. Um den Fehlercode abzurufen, rufen Sie die GetLastError-Funktion auf.

Hinweise

Vorsicht

EvtGetEventMetadataProperty kann viele verschiedene Arten von Werten in der EventMetadataPropertyBuffer-Variable zurückgeben. Wenn EventMetadataPropertyBuffer-Type> == EvtVarTypeEvtHandle enthält EventMetadataPropertyBuffer ein Handle, das freigegeben werden muss. Wenn Sie mit dem Handle fertig sind, rufen Sie die Funktion EvtClose auf.

Beispiele

Ein Beispiel für die Verwendung dieser Funktion finden Sie unter Abrufen der Metadaten eines Anbieters.

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

EvtOpenPublisherMetadata

Freigeben über