PdhSelectDataSourceA-Funktion (pdh.h)

Artikel
08/25/2023

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 zum Besitzer).

[in] dwFlags

Dialogfelder, die angezeigt werden, um zur Eingabe der Datenquelle aufzufordern. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
PDH_FLAGS_FILE_BROWSER_ONLY	Zeigt nur den Dateibrowser an. Legen Sie dieses Flag fest, wenn Sie nur zur Eingabe des Namens und speicherorts einer Protokolldatei auffordern möchten.
0	Zeigt das Dialogfeld für die Datenquellenauswahl an. Im Dialogfeld können Benutzer Leistungsdaten entweder aus einer Protokolldatei oder einer Echtzeitquelle auswählen. Wenn der Benutzer angegeben hat, dass Daten aus einer Protokolldatei gesammelt werden sollen, wird ein Dateibrowser angezeigt, in dem der Benutzer den Namen und speicherort der Protokolldatei angeben kann.

[out] szDataSource

Vom Aufrufer zugewiesener Puffer, der eine NULL-endende Zeichenfolge empfängt, die den Namen einer protokolldatei enthält, die der Benutzer ausgewählt hat. 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. Die folgenden Werte sind möglich.

Rückgabecode	Beschreibung
PDH_INVALID_ARGUMENT	Die Länge des Puffers, der im pcchBufferLength übergeben wird, ist nicht gleich der tatsächlichen Länge des szDataSource-Puffers .
PDH_MEMORY_ALLOCATION_FAILURE	Im szDataSource-Parameter wurde ein Puffer der Länge null übergeben.

Hinweise

Hinweis

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
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

Weitere Informationen

PdhIsRealTimeQuery

Freigeben über