EvtOpenPublisherMetadata-Funktion (winevt.h)

Ruft ein Handle ab, das Sie zum Lesen der Metadaten des angegebenen Anbieters verwenden.

Syntax

EVT_HANDLE EvtOpenPublisherMetadata(
  [in, optional] EVT_HANDLE Session,
  [in]           LPCWSTR    PublisherId,
  [in, optional] LPCWSTR    LogFilePath,
  [in]           LCID       Locale,
  [in]           DWORD      Flags
);

Parameter

[in, optional] Session

Ein Remotesitzungshandle, das von der EvtOpenSession-Funktion zurückgegeben wird. Legen Sie auf NULL fest, um die Metadaten für einen Anbieter auf dem lokalen Computer abzurufen.

[in] PublisherId

Der Name des Anbieters. Rufen Sie die EvtOpenPublisherEnum-Funktion auf, um die Namen der auf dem Computer registrierten Anbieter aufzulisten.

[in, optional] LogFilePath

Der vollständige Pfad zu einer archivierten Protokolldatei, die die vom Anbieter protokollierten Ereignisse enthält. Eine archivierte Protokolldatei enthält auch die Metadaten des Anbieters. Verwenden Sie diesen Parameter, wenn der Anbieter nicht auf dem lokalen Computer registriert ist. Legen Sie beim Lesen der Metadaten von einem registrierten Anbieter auf NULL fest.

[in] Locale

Der Gebietsschemabezeichner, der beim Zugriff auf die lokalisierten Metadaten vom Anbieter verwendet werden soll. Verwenden Sie zum Erstellen des Gebietsschemabezeichners das MAKELCID-Makro. Legen Sie auf 0 fest, um den Gebietsschemabezeichner des aufrufenden Threads zu verwenden.

[in] Flags

Reserviert. Muss Null sein.

Rückgabewert

Bei erfolgreicher Ausführung gibt die Funktion ein Handle für die Metadaten des Anbieters zurück. andernfalls NULL. Wenn NULL, rufen Sie die GetLastError-Funktion auf, um den Fehlercode abzurufen.

Hinweise

Wenn Sie eine archivierte Protokolldatei angeben, sucht diese Funktion in der Protokolldatei nach den Metadaten des angegebenen Anbieters. Wenn die Metadaten des Anbieters nicht in der Protokolldatei gefunden werden, sucht die Funktion in der Liste der registrierten Anbieter auf dem lokalen Computer nach dem Anbieter.

Um die Metadaten des Anbieters zu lesen, rufen Sie die EvtGetPublisherMetadataProperty-Funktion auf. Rufen Sie die EvtOpenEventMetadataEnum-Funktion auf, um die Vom Anbieter definierten Ereignisse aufzulisten.

Sie müssen die EvtClose-Funktion aufrufen, um das Metadatenhandle zu schließen, wenn Sie fertig sind.

Beispiele

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

Anforderungen

Weitere Informationen

EvtGetPublisherMetadataProperty

EvtOpenEventMetadataEnum

EvtOpenPublisherEnum