CM_Is_Dock_Station_Present_Ex, fonction (cfgmgr32.h)

Article
02/23/2024

[À compter de Windows 8 et Windows Server 2012, cette fonction a été déconseillée. Utilisez CM_Is_Dock_Station_Present à la place.]

La fonction CM_Is_Dock_Station_Present_Ex identifie si une station d’accueil est présente sur un ordinateur local ou distant.

Syntaxe

CMAPI CONFIGRET CM_Is_Dock_Station_Present_Ex(
  [out]          PBOOL    pbPresent,
  [in, optional] HMACHINE hMachine
);

Paramètres

[out] pbPresent

Pointeur vers une valeur booléenne qui indique si une station d’accueil est présente sur un ordinateur local. La fonction définit *pbPresent sur TRUE si une station d’accueil est présente. La fonction définit *pbPresent surFALSE si la fonction ne peut pas se connecter à l’ordinateur spécifié ou si une station d’accueil n’est pas présente.

[in, optional] hMachine

Fournit un handle de machine retourné par CM_Connect_Machine.

Note L’utilisation de cette fonction pour accéder aux machines distantes n’est pas prise en charge à partir de Windows 8 et Windows Server 2012, car cette fonctionnalité a été supprimée.

Valeur retournée

Si l’opération réussit, la fonction retourne CR_SUCCESS. Sinon, la fonction retourne l’un des codes d’erreur préfixés CR_ définis dans Cfgmgr32.h.

Remarques

Utilisez cette fonction pour déterminer si une station d’accueil est présente sur un ordinateur local ou distant. Vous pouvez également utiliser les fonctions associées suivantes avec des stations d’accueil :

CM_Is_Dock_Station_Present identifie si une station d’accueil est présente sur un ordinateur local.
CM_Request_Eject_PC demande qu’un PC portable, qui est inséré dans une station d’accueil locale, soit éjecté.
CM_Request_Eject_PC_Ex demande qu’un PC portable, qui est inséré dans une station d’accueil locale ou distante, soit éjecté.

La fonctionnalité permettant d’accéder aux ordinateurs distants a été supprimée dans Windows 8 et Windows Server 2012 systèmes d’exploitation et versions ultérieures. Vous ne pouvez donc pas accéder aux ordinateurs distants lors de l’exécution sur ces versions de Windows.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	cfgmgr32.h (inclure Cfgmgr32.h)
Bibliothèque	Cfgmgr32.lib
DLL	Cfgmgr32.dll

Voir aussi

CM_Is_Dock_Station_Present

CM_Request_Eject_PC

CM_Request_Eject_PC_Ex

Partager via