PdhBindInputDataSourceA-Funktion (pdh.h)

Artikel
03/06/2024

Bindet eine oder mehrere Binärprotokolldateien zum Lesen von Protokolldaten.

Syntax

PDH_FUNCTION PdhBindInputDataSourceA(
  [out] PDH_HLOG *phDataSource,
  [in]  LPCSTR   LogFileNameList
);

Parameter

[out] phDataSource

Behandeln Sie die gebundenen Datenquellen.

[in] LogFileNameList

NULL-Zeichenfolge, die eine oder mehrere binäre Protokolldateien enthält, die aneinander gebunden werden sollen. Beenden Sie jeden Namen der Protokolldatei mit einem NULL-Abschlusszeichen und die Liste mit einem zusätzlichen NULL-Abschlusszeichen. Die Namen der Protokolldateien können absolute oder relative Pfade enthalten. Sie können nicht mehr als 32 Protokolldateien angeben.

Bei NULL ist die Quelle eine Echtzeitdatenquelle.

Rückgabewert

Gibt ERROR_SUCCESS zurück, wenn die Funktion erfolgreich ist.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode oder ein PDH-Fehlercode.

Hinweise

Diese Funktion wird mit den PDH-Funktionen verwendet, für die ein Handle für eine Datenquelle erforderlich ist. Eine Liste dieser Funktionen finden Sie unter Siehe auch.

Sie können nicht mehr als eine durch Kommas getrennte Datei (CSV) oder TSV-Datei (Tab-Trennzeichen) angeben. Die Liste kann nur einen Dateityp enthalten. Sie können nicht mehrere Dateitypen kombinieren.

Um die gebundenen Protokolldateien zu schließen, rufen Sie die PdhCloseLog-Funktion mithilfe des Protokollhandles auf.

Hinweis

Der pdh.h-Header definiert PdhBindInputDataSource als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	pdh.h
Bibliothek	Pdh.lib
DLL	Pdh.dll