Função CM_Get_DevNode_Status_Ex (cfgmgr32.h)
[Começando com Windows 8 e Windows Server 2012, essa função foi preterida. Em vez disso, use CM_Get_DevNode_Status .]
A função CM_Get_DevNode_Status_Ex obtém o status de uma instância de dispositivo de seu nó de dispositivo (devnode) em uma árvore de dispositivos local ou remota.
Sintaxe
CMAPI CONFIGRET CM_Get_DevNode_Status_Ex(
[out] PULONG pulStatus,
[out] PULONG pulProblemNumber,
[in] DEVINST dnDevInst,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
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 bits prefixados por 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 identificador de computador fornecido por hMachine.
[in] ulFlags
Não usado, deve ser zero.
[in, optional] hMachine
Identificador de computador fornecido pelo chamador ao qual o identificador de instância do dispositivo fornecido pelo chamador está associado.
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 a um computador local ou remoto, consulte CM_Get_Child_Ex.
A funcionalidade para acessar computadores remotos foi removida em Windows 8 e Windows Server 2012 e sistemas operacionais posteriores, portanto, você não pode acessar computadores remotos durante a execução nessas versões do Windows.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Disponível no Microsoft Windows 2000 e versões posteriores do Windows. |
Plataforma de Destino | Área de Trabalho |
Cabeçalho | cfgmgr32.h (inclua Cfgmgr32.h) |
Biblioteca | Cfgmgr32.lib |
DLL | Cfgmgr32.dll |