CM_Setup_DevNode función (cfgmgr32.h)

Artículo
08/22/2023

La función CM_Setup_DevNode reinicia una instancia de dispositivo que no se está ejecutando porque hay un problema con la configuración del dispositivo.

Sintaxis

CMAPI CONFIGRET CM_Setup_DevNode(
  [in] DEVINST dnDevInst,
  [in] ULONG   ulFlags
);

Parámetros

[in] dnDevInst

Identificador de instancia de dispositivo enlazado al sistema local.

[in] ulFlags

Uno de los siguientes valores de marca:

CM_SETUP_DEVNODE_READY

Reinicia una instancia de dispositivo que no se está ejecutando debido a un problema con la configuración del dispositivo.

CM_SETUP_DEVNODE_RESET (Windows XP y versiones posteriores de Windows)

Restablece una instancia de dispositivo que no tiene establecida la marca de estado del dispositivo de reinicio. La marca de estado del dispositivo sin reinicio se establece si se quita un dispositivo llamando a CM_Query_And_Remove_SubTree o CM_Query_And_Remove_SubTree_Ex y especificando la marca CM_REMOVE_NO_RESTART.

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 con el prefijo "CR_" que se definen en Cfgmgr32.h.

Comentarios

Las aplicaciones de instalación de dispositivos deben usar la solicitud de DIF_PROPERTYCHANGE para reiniciar un dispositivo en lugar de usar esta función. La solicitud DIF_PROPERTYCHANGE se puede usar para habilitar, deshabilitar, reiniciar, detener o cambiar las propiedades de un dispositivo.

Si una instancia de dispositivo no tiene un problema y ya está iniciada, CM_Setup_DevNode devuelve sin cambiar el estado de la instancia del dispositivo.

Llame a CM_Get_DevNode_Status o CM_Get_DevNode_Status_Ex para determinar el estado y el código de problema de una instancia de dispositivo.

Requisitos


Cliente mínimo compatible	Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino	Universal
Encabezado	cfgmgr32.h (incluya Cfgmgr32.h)
Library	Cfgmgr32.lib; OneCoreUAP.lib en Windows 10
Archivo DLL	CfgMgr32.dll