PdhConnectMachineA, fonction (pdh.h)
Se connecte à l’ordinateur spécifié.
Syntaxe
PDH_FUNCTION PdhConnectMachineA(
[in] LPCSTR szMachineName
);
Paramètres
[in] szMachineName
chaîne null-terminated qui spécifie le nom de l’ordinateur auquel se connecter. Si NULL, PDH se connecte à l’ordinateur local.
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 |
|---|---|
|
Impossible de se connecter à l’ordinateur spécifié. L’ordinateur n’est pas activé, ne prend pas en charge PDH, n’est pas connecté au réseau ou dispose des autorisations définies sur le Registre qui empêchent les connexions distantes ou l’analyse des performances à distance par l’utilisateur. |
|
Impossible d’allouer un bloc de mémoire dynamique. Se produit lorsqu’il y a une grave pénurie de mémoire dans le système en raison d’un trop grand nombre d’applications s’exécutant 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 et 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 boîte de dialogue Sélectionner des compteurs à partir de l’ordinateur liste dans la boîte de dialogue Parcourir les compteurs. Pour plus d’informations, consultez la structure PDH_BROWSE_DLG_CONFIG.
Note
L’en-tête pdh.h définit PdhConnectMachine 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 |