Partager via

PdhConnectMachineA, fonction (pdh.h)

  • Article

Se connecte à l’ordinateur spécifié.

Syntaxe

PDH_FUNCTION PdhConnectMachineA(
  [in] LPCSTR szMachineName
);

Paramètres

[in] szMachineName

Chaîne terminée par null qui spécifie le nom de l’ordinateur auquel se connecter. Si la valeur est NULL, PDH se connecte à l’ordinateur local.

Valeur retournée

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.

Code de retour Description
PDH_CSTATUS_NO_MACHINE
 Impossible de se connecter à l’ordinateur spécifié. Peut être dû au fait que l’ordinateur n’est pas allumé, ne prend pas en charge PDH, n’est pas connecté au réseau ou que les autorisations définies sur le Registre empêchent les connexions à distance ou la surveillance des performances à distance par l’utilisateur.
PDH_MEMORY_ALLOCATION_FAILURE
 Impossible d’allouer un bloc de mémoire dynamique. Se produit en cas de grave pénurie de mémoire dans le système en raison d’un trop grand nombre d’applications exécutées sur le système ou d’un fichier de pagination de mémoire insuffisant.

Remarques

En règle générale, les applications n’appellent pas cette fonction, mais la connexion est établie lorsque l’application ajoute le compteur à la requête.

Toutefois, vous pouvez utiliser cette fonction si vous souhaitez inclure plus que l’ordinateur local dans la liste Sélectionner des compteurs à partir d’ordinateurs de la boîte de dialogue Parcourir les compteurs . Pour plus d’informations, consultez la structure PDH_BROWSE_DLG_CONFIG .

Notes

L’en-tête pdh.h définit PdhConnectMachine en tant qu’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. La combinaison 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

PdhEnumMachines