PdhVbOpenLog-Funktion
Die PdhVbOpenLog-Funktion öffnet die angegebene Protokolldatei zum Lesen und Schreiben. Diese Funktion ruft PdhOpenLogauf.
Wichtig
Die in diesem Thema beschriebene Funktion kann in Zukunft geändert oder nicht mehr verfügbar sein. Stattdessen empfiehlt Microsoft die Verwendung der in Leistungsindikatorfunktionen beschriebenenFunktionen.
Funktion PdhVbOpenLog( _ ByVal szLogFileName as LPCTSTR, _ ByVal dwAccessFlags as DWORD, _ ByVal lpdwLogType as LPDWORD, _ ByVal hQuery as PDH _ HQUERY, _ ByVal dwMaxSize As DWORD, _ ByVal szUserCaption As LPCSTR, _ ByRef phLog as PDH _ HLOG _ ) As DWORD
Parameter
-
szLogFileName [ In]
-
Zeiger auf eine Zeichenfolge, die den Namen der zu öffnenden Protokolldatei angibt.
Wenn die Protokolldatei SQL Daten enthält, lautet das Format des Namens der Protokolldatei SQL:DataSourceName! LogFileName. In diesem Fall ist der Wert des lpdwLogType-Parameters PDH _ LOG TYPE _ _ SQL.
-
dwAccessFlags [ In]
-
Der Zugriffstyp, der beim Öffnen der Protokolldatei angegeben werden soll. Dieser Parameter kann einen der folgenden Werte annehmen.
Wert Bedeutung - LESEZUGRIFF AUF PDH-PROTOKOLLE _ _ _
Eine Protokolldatei wird für einen Lesevorgang geöffnet. - SCHREIBZUGRIFF AUF PDH-PROTOKOLL _ _ _
Für einen Schreibvorgang wird eine neue Protokolldatei geöffnet. - ZUGRIFF _ AUF PDH-PROTOKOLLUPDATES _ _
Eine vorhandene Protokolldatei wird für einen Schreibvorgang geöffnet. Der in der vorherigen Tabelle ausgewählte Wert kann mithilfe des OR-Operators mit einem der folgenden Create Access Flags kombiniert werden.
Wert Bedeutung - PDH _ LOG _ CREATE _ NEW
Eine neue Protokolldatei mit dem angegebenen Namen wird erstellt. - PDH _ LOG _ CREATE _ ALWAYS
Eine neue Protokolldatei mit dem angegebenen Namen wird erstellt, und alle vorhandenen Protokolldateien mit dem gleichen Namen werden gelöscht. - PDH _ LOG _ OPEN _ EXISTING
Eine vorhandene Protokolldatei mit dem angegebenen Namen wird geöffnet. Wenn keine Protokolldatei mit dem angegebenen Namen vorhanden ist, entspricht dies PDH _ LOG _ CREATE _ NEW. - PDH _ LOG _ OPEN _ ALWAYS
Eine vorhandene Protokolldatei mit dem angegebenen Namen wird geöffnet, oder es wird eine neue Protokolldatei mit dem angegebenen Namen erstellt. -
lpdwLogType [ In]
-
Zeiger auf eine Variable, die den Typ der zu öffnenden Protokolldatei angibt. Dieser Parameter kann einen der folgenden Werte annehmen.
Wert Bedeutung - PDH _ LOG _ TYPE _ UNDEFINED
Nicht definiertes Protokolldateiformat. - _PDH-PROTOKOLLTYP _ _ CSV
Textdateien, die Spaltenüberschriften in der ersten Zeile und einzelne Datenbeispiele in jeder nachfolgenden Zeile enthalten. - PDH _ LOG _ TYPE _ SQL
Die Daten in der Protokolldatei sind SQL. - PDH _ LOG _ TYPE _ TSV
Entspricht DEM _ _ PDH-PROTOKOLLTYP _ CSV. - PDH _ LOG _ TYPE _ BINARY
Binäres Protokolldateiformat. Schließt zirkuläre Protokolldateien ein. - _PDH-PROTOKOLLTYP _ _ PERFMON
Perfmon-Protokolldateiformat. -
hQuery [ In]
-
Abfragehandle. Dieses Handle wird von der PdhVbOpenQuery-Funktion zurückgegeben.
Dieser Parameter kann NULL sein, wenn die Protokolldatei zum Lesen geöffnet werden soll.
-
dwMaxSize [ In]
-
Maximale Größe der Protokolldatei in Bytes. Dieser Wert wird nur verwendet, wenn es sich bei der Protokolldatei um eine Datei mit begrenzter Größe oder um eine kreisförmige Protokolldatei handelt.
-
szUserCaption [ In]
-
Zeiger auf eine Zeichenfolge, die die benutzerdefinierte Beschriftung der Protokolldatei angibt. Eine Protokolldateibeschriftung beschreibt im Allgemeinen den Inhalt der Protokolldatei. Wenn eine vorhandene Protokolldatei geöffnet wird, wird der Wert dieses Parameters ignoriert.
-
phLog [ in, ref]
-
Zeiger auf einen Puffer, der ein Handle für die geöffnete Protokolldatei empfängt.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird 0 zurückgegeben.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode oder ein PDH-Fehlercode. Im Folgenden sind mögliche Werte angegeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Die angeforderten Daten sind größer als der bereitgestellte Puffer. Die angeforderten Daten können nicht zurückgegeben werden. |
|
Mindestens einer der Zeichenfolgenpuffer ist nicht die richtige Größe. |
|
Das Handle ist kein gültiges PDH-Objekt. |
|
Die angegebene Protokolldatei kann nicht geöffnet werden. |
|
Die angegebene Datei konnte nicht gefunden werden. |
Hinweise
Wenn Sie diese Funktion verwenden, um Leistungsdaten in eine Protokolldatei zu schreiben, muss zuerst eine Abfrage mit pdhVbOpenQuerygeöffnet werden.
Es muss eine derzeit geöffnete Abfrage vorhanden sein, und die gewünschten Leistungsindikatoren müssen ihr hinzugefügt werden, bevor diese Funktion aufgerufen wird.
Beachten Sie, dass Protokolldateien im Perfmon-Format nur zum Lesen geöffnet werden können.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows [Nur XP-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| Bibliothek |
|
| DLL |
|