PdhSelectDataSourceA, fonction (pdh.h)

Article
08/25/2023

Affiche une fenêtre de dialogue qui invite l’utilisateur à spécifier la source des données de performances.

Syntaxe

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

Paramètres

[in] hWndOwner

Propriétaire de la fenêtre de dialogue. Cela peut être NULL s’il n’y a pas de propriétaire (le bureau devient propriétaire).

[in] dwFlags

Boîtes de dialogue qui s’affichent pour demander la source de données. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
PDH_FLAGS_FILE_BROWSER_ONLY	Affichez le navigateur de fichiers uniquement. Définissez cet indicateur lorsque vous souhaitez demander le nom et l’emplacement d’un fichier journal uniquement.
0	Afficher la boîte de dialogue de sélection de la source de données. La boîte de dialogue permet à l’utilisateur de sélectionner des données de performances à partir d’un fichier journal ou d’une source en temps réel. Si l’utilisateur a spécifié que les données doivent être collectées à partir d’un fichier journal, un navigateur de fichiers s’affiche pour que l’utilisateur spécifie le nom et l’emplacement du fichier journal.

Valeur

Signification

PDH_FLAGS_FILE_BROWSER_ONLY

Affichez le navigateur de fichiers uniquement. Définissez cet indicateur lorsque vous souhaitez demander le nom et l’emplacement d’un fichier journal uniquement.

0

Afficher la boîte de dialogue de sélection de la source de données. La boîte de dialogue permet à l’utilisateur de sélectionner des données de performances à partir d’un fichier journal ou d’une source en temps réel. Si l’utilisateur a spécifié que les données doivent être collectées à partir d’un fichier journal, un navigateur de fichiers s’affiche pour que l’utilisateur spécifie le nom et l’emplacement du fichier journal.

[out] szDataSource

Mémoire tampon allouée à l’appelant qui reçoit une chaîne terminée par null qui contient le nom d’un fichier journal que l’utilisateur a sélectionné. Le nom du fichier journal est tronqué à la taille de la mémoire tampon si la mémoire tampon est trop petite.

Si l’utilisateur a sélectionné une source en temps réel, la mémoire tampon est vide.

[in, out] pcchBufferLength

Taille maximale de la mémoire tampon szDataSource , en TCHAR.

Valeur retournée

Si la fonction réussit, elle retourne ERROR_SUCCESS.

Si la fonction échoue, la valeur renvoyée est un code d’erreur système ou un code d’erreur PDH. Voici les valeurs possibles.

Code de retour	Description
PDH_INVALID_ARGUMENT	La longueur de la mémoire tampon passée dans pcchBufferLength n’est pas égale à la longueur réelle de la mémoire tampon szDataSource .
PDH_MEMORY_ALLOCATION_FAILURE	Une mémoire tampon de longueur nulle a été passée dans le paramètre szDataSource .

Remarques

Notes

L’en-tête pdh.h définit PdhSelectDataSource comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	pdh.h
Bibliothèque	Pdh.lib
DLL	Pdh.dll

Voir aussi

PdhIsRealTimeQuery

Share via