función CM_Get_DevNode_Status (cfgmgr32.h)

La función CM_Get_DevNode_Status obtiene el estado de una instancia de dispositivo de su nodo de dispositivo (devnode) en el árbol de dispositivos del equipo local.

Nota

En Windows Vista y versiones posteriores, el modelo de propiedad de dispositivo unificado usa la clave de propiedadDEVPKEY_Device_DevNodeStatus para representar el identificador de instancia del dispositivo. Para obtener más información, consulte Recuperación del estado y el código de problema de una instancia de dispositivo.

Sintaxis

CMAPI CONFIGRET CM_Get_DevNode_Status(
  [out] PULONG  pulStatus,
  [out] PULONG  pulProblemNumber,
  [in]  DEVINST dnDevInst,
  [in]  ULONG   ulFlags
);

Parámetros

[out] pulStatus

Dirección de una ubicación para recibir marcas de bits de estado. La función puede establecer cualquier combinación de las marcas de bits con prefijo DN_ definidas en Cfg.h.

[out] pulProblemNumber

Dirección de una ubicación para recibir uno de los valores de problema con prefijo CM_PROB_ definidos en Cfg.h. Solo se usa si DN_HAS_PROBLEM se establece en pulStatus.

[in] dnDevInst

Identificador de instancia de dispositivo proporcionado por el autor de la llamada que está enlazado al equipo local.

[in] ulFlags

No se usa, debe ser cero.

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

Para obtener información sobre el uso de identificadores de instancia de dispositivo enlazados a la máquina local, consulte CM_Get_Child.

Requisitos

Requisito	Value
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

Consulte también

CM_Get_Child

CM_Get_DevNode_Status_Ex