PdhConnectMachineA, fonction (pdh.h)
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 |
|---|---|
|
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. |
|
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 |