función CM_Is_Dock_Station_Present_Ex (cfgmgr32.h)

  • Artículo

[A partir de Windows 8 y Windows Server 2012, esta función ha quedado en desuso. Use CM_Is_Dock_Station_Present en su lugar.

La función CM_Is_Dock_Station_Present_Ex identifica si una estación de acoplamiento está presente en un equipo local o remoto.

Sintaxis

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

Parámetros

[out] pbPresent

Puntero a un valor booleano que indica si una estación de acoplamiento está presente en un equipo local. La función establece *pbPresent en TRUE si existe una estación de acoplamiento. La función establece *pbPresent en FALSE si la función no puede conectarse al equipo especificado o a una estación de acoplamiento no está presente.

[in, optional] hMachine

Proporciona un identificador de máquina devuelto por CM_Connect_Machine.

Nota No se admite el uso de esta función para acceder a máquinas remotas a partir de Windows 8 y Windows Server 2012, ya que esta funcionalidad se ha quitado.
 

Valor devuelto

Si la operación se realiza correctamente, la función devuelve CR_SUCCESS. De lo contrario, la función devuelve uno de los códigos de error con prefijo CR_ definidos en Cfgmgr32.h.

Comentarios

Use esta función para determinar si una estación de acoplamiento está presente en un equipo local o remoto. También puede usar las siguientes funciones relacionadas con estaciones de acoplamiento:

La funcionalidad para acceder a las máquinas remotas se ha quitado en Windows 8 y sistemas operativos Windows Server 2012 y versiones posteriores, por lo que no se puede acceder a las máquinas remotas cuando se ejecutan en estas versiones de Windows.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino Escritorio
Encabezado cfgmgr32.h (incluya Cfgmgr32.h)
Library Cfgmgr32.lib
Archivo DLL Cfgmgr32.dll

Consulte también

CM_Is_Dock_Station_Present

CM_Request_Eject_PC

CM_Request_Eject_PC_Ex