Freigeben über


PdhBindInputDataSourceA-Funktion (pdh.h)

Bindet eine oder mehrere binäre Protokolldateien zum Lesen von Protokolldaten zusammen.

Syntax

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

Parameter

[out] phDataSource

Behandeln sie die gebundenen Datenquellen.

[in] LogFileNameList

null-terminated string that contains one or more binary log files to bind. Beenden Sie jeden Protokolldateinamen mit einem Nullzeichen-terminator und der Liste mit einem zusätzlichen null-terminator-Zeichen. Die Namen der Protokolldateien können absolute oder relative Pfade enthalten. Sie können nicht mehr als 32 Protokolldateien angeben.

Wenn NULL-, handelt es sich bei der Quelle um 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.

Bemerkungen

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

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

Rufen Sie zum Schließen der gebundenen Protokolldateien die PdhCloseLog--Funktion mithilfe des Protokollhandle auf.

Anmerkung

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 Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client- Windows XP [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Zielplattform- Fenster
Header- pdh.h
Library Pdh.lib
DLL- Pdh.dll

Siehe auch

PdhBrowseCountersH

PdhEnumMachinesH

PdhEnumObjectItemsH

PdhEnumObjectsH

PdhExpandWildCardPathH

PdhGetDataSourceTimeRangeH-

PdhGetDefaultPerfCounterH

PdhGetDefaultPerfaultPerfObjectH

PdhOpenQueryH