PdhSelectDataSourceA, fonction (pdh.h)

Article
11/20/2024

Affiche une fenêtre de boîte 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 le propriétaire).

[in] dwFlags

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

Valeur	Signification
PDH_FLAGS_FILE_BROWSER_ONLY	Affichez uniquement le navigateur de fichiers. Définissez cet indicateur lorsque vous souhaitez demander le nom et l’emplacement d’un fichier journal uniquement.
0	Affichez 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 uniquement le navigateur de fichiers. Définissez cet indicateur lorsque vous souhaitez demander le nom et l’emplacement d’un fichier journal uniquement.

0

Affichez 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 par l’appelant qui reçoit une chaîne null-terminated qui contient le nom d’un fichier journal sélectionné par l’utilisateur. 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 , dans TCHAR .

Valeur de retour

Si la fonction réussit, elle retourne ERROR_SUCCESS.

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

Retourner le code	Description
PDH_INVALID_ARGUMENT	La longueur de la mémoire tampon passée dans le 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

Note

L’en-tête pdh.h définit PdhSelectDataSource comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	pdh.h
bibliothèque	Pdh.lib
DLL	Pdh.dll

Voir aussi

PdhIsRealTimeQuery

Partager via