Compartir a través de

función CM_Connect_MachineW (cfgmgr32.h)

  • Artículo

[A partir de Windows 8 y Windows Server 2012 funcionalidad para acceder a las máquinas remotas se ha quitado. No se puede acceder a las máquinas remotas cuando se ejecutan en estas versiones de Windows.

La función CM_Connect_Machine crea una conexión a una máquina remota.

Sintaxis

CMAPI CONFIGRET CM_Connect_MachineW(
  [in, optional] PCWSTR    UNCServerName,
  [out]          PHMACHINE phMachine
);

Parámetros

[in, optional] UNCServerName

Puntero proporcionado por el autor de la llamada a una cadena de texto que representa el nombre UNC, incluido el \ prefijo, del sistema para el que se realizará una conexión. Si el puntero es NULL, se usa el sistema local.

[out] phMachine

Dirección de una ubicación para recibir un identificador de máquina.

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, devuelve uno de los códigos de error CR_ prefijo definidos en Cfgmgr32.h.

Comentarios

Los autores de llamadas de CM_Connect_Machine deben llamar a CM_Disconnect_Machine para desasignar el identificador de la máquina, después de que ya no sea necesario.

Use identificadores de máquina obtenidos con esta función solo con las funciones del administrador de configuración de PnP.

La funcionalidad para acceder a las máquinas remotas se ha quitado en Windows 8 y Windows Server 2012 y sistemas operativos 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

Consulte también

CM_Disconnect_Machine