PdhSelectDataSourceA-Funktion (pdh.h)

Artikel
11/20/2024

Zeigt ein Dialogfeld an, in dem der Benutzer aufgefordert wird, die Quelle der Leistungsdaten anzugeben.

Syntax

PDH_FUNCTION PdhSelectDataSourceA(
  [in]      HWND    hWndOwner,
  [in]      DWORD   dwFlags,
  [out]     LPSTR   szDataSource,
  [in, out] LPDWORD pcchBufferLength
);

Parameter

[in] hWndOwner

Besitzer des Dialogfelds. Dies kann NULL- sein, wenn kein Besitzer vorhanden ist (der Desktop wird der Besitzer).

[in] dwFlags

Dialogfelder, die angezeigt werden, um zur Eingabe der Datenquelle aufzufordern. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
PDH_FLAGS_FILE_BROWSER_ONLY	Nur den Dateibrowser anzeigen. Legen Sie dieses Kennzeichen fest, wenn Sie nur den Namen und speicherort einer Protokolldatei anfordern möchten.
0	Anzeigen des Dialogfelds "Datenquellenauswahl". Im Dialogfeld können Benutzer Leistungsdaten aus einer Protokolldatei oder einer Echtzeitquelle auswählen. Wenn der Benutzer angegeben hat, dass die Daten aus einer Protokolldatei erfasst werden sollen, wird ein Dateibrowser angezeigt, damit der Benutzer den Namen und speicherort der Protokolldatei angeben kann.

[out] szDataSource

Vom Aufrufer zugewiesener Puffer, der eine NULL--terminated-Zeichenfolge empfängt, die den Namen einer vom Benutzer ausgewählten Protokolldatei enthält. Der Name der Protokolldatei wird auf die Größe des Puffers abgeschnitten, wenn der Puffer zu klein ist.

Wenn der Benutzer eine Echtzeitquelle ausgewählt hat, ist der Puffer leer.

[in, out] pcchBufferLength

Maximale Größe des szDataSource- Puffers in TCHARs.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ERROR_SUCCESS zurückgegeben.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode oder ein PDH-Fehlercode. Im Folgenden sind mögliche Werte aufgeführt.

Rückgabecode	Beschreibung
PDH_INVALID_ARGUMENT	Die Länge des im pcchBufferLength übergebenen Puffers entspricht nicht der tatsächlichen Länge des szDataSource Puffers.
PDH_MEMORY_ALLOCATION_FAILURE	Ein Puffer der Länge Null wurde im szDataSource-Parameter übergeben.

Bemerkungen

Anmerkung

Der pdh.h-Header definiert PdhSelectDataSource 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

PdhIsRealTimeQuery

Freigeben über