función CM_Set_DevNode_Problem_Ex (cfgmgr32.h)

  • Artículo

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

La función CM_Set_DevNode_Problem_Ex establece un código de problema para un dispositivo instalado en un equipo local o remoto.

Sintaxis

CMAPI CONFIGRET CM_Set_DevNode_Problem_Ex(
  [in]           DEVINST  dnDevInst,
  [in]           ULONG    ulProblem,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parámetros

[in] dnDevInst

Identificador de instancia de dispositivo proporcionado por el autor de la llamada que está enlazado al controlador de máquina proporcionado por hMachine.

[in] ulProblem

Proporciona un código de problema, que es cero o una de las marcas de CM_PROB_Xxx que se describen en Administrador de dispositivos mensajes de error. Un valor de cero indica que no se ha establecido un código de problema para el dispositivo.

[in] ulFlags

Debe establecerse en cero.

[in, optional] hMachine

Identificador de máquina proporcionado por el autor de la llamada al que está enlazado el identificador de instancia de dispositivo proporcionado por el autor de la llamada.

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 establecer un código de problema para un dispositivo instalado en un equipo local o remoto. También puede usar las siguientes funciones para establecer el código de problema de un dispositivo y obtener el código del problema establecido para el dispositivo:

  • CM_Get_DevNode_Status devuelve el código de problema establecido para un dispositivo instalado en un equipo local.

  • CM_Get_DevNode_Status_Ex devuelve el código de problema establecido para un dispositivo instalado en un equipo local o remoto.

  • CM_Set_DevNode_Problem establece un código de problema para un dispositivo instalado en un equipo local.

Para obtener información sobre el uso de identificadores de instancia de dispositivo enlazados a un equipo local o remoto, consulte CM_Get_Child_Ex.

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_Get_Child_Ex

CM_Get_DevNode_Status

CM_Get_DevNode_Status_Ex

CM_Set_DevNode_Problem