Função CM_Get_DevNode_Status (cfgmgr32.h)

A função CM_Get_DevNode_Status obtém o status de uma instância de dispositivo de seu nó de dispositivo (devnode) na árvore de dispositivos do computador local.

Observação

No Windows Vista e posterior, o modelo de propriedade do dispositivo unificado usa a chave de propriedadeDEVPKEY_Device_DevNodeStatus para representar o identificador de instância do dispositivo. Para obter detalhes, consulte Recuperando a status e o código do problema para uma instância de dispositivo.

Sintaxe

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

Parâmetros

[out] pulStatus

Endereço de um local para receber status sinalizadores de bits. A função pode definir qualquer combinação dos sinalizadores de bit prefixado DN_ definidos em Cfg.h.

[out] pulProblemNumber

Endereço de um local para receber um dos valores de problema prefixados por CM_PROB_ definidos em Cfg.h. Usado somente se DN_HAS_PROBLEM estiver definido em pulStatus.

[in] dnDevInst

Identificador de instância de dispositivo fornecido pelo chamador associado ao computador local.

[in] ulFlags

Não usado, deve ser zero.

Retornar valor

Se a operação for bem-sucedida, a função retornará CR_SUCCESS. Caso contrário, ele retornará um dos códigos de erro prefixados por CR_ definidos em Cfgmgr32.h.

Comentários

Para obter informações sobre como usar identificadores de instância de dispositivo associados ao computador local, consulte CM_Get_Child.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
Plataforma de Destino	Universal
Cabeçalho	cfgmgr32.h (inclua Cfgmgr32.h)
Biblioteca	Cfgmgr32.lib; OneCoreUAP.lib no Windows 10
DLL	CfgMgr32.dll

Confira também

CM_Get_Child

CM_Get_DevNode_Status_Ex