função CM_Setup_DevNode (cfgmgr32.h)
A função CM_Setup_DevNode reinicia uma instância de dispositivo que não está em execução porque há um problema com a configuração do dispositivo.
Sintaxe
CMAPI CONFIGRET CM_Setup_DevNode(
[in] DEVINST dnDevInst,
[in] ULONG ulFlags
);
Parâmetros
[in] dnDevInst
Um identificador de instância do dispositivo associado ao sistema local.
[in] ulFlags
Um dos seguintes valores de sinalizador:
CM_SETUP_DEVNODE_READY
Reinicia uma instância de dispositivo que não está em execução devido a um problema com a configuração do dispositivo.
CM_SETUP_DEVNODE_RESET (Windows XP e versões posteriores do Windows)
Redefine uma instância de dispositivo que não tem o dispositivo de reinicialização status conjunto de sinalizadores. O sinalizador de status do dispositivo sem reinicialização será definido se um dispositivo for removido chamando CM_Query_And_Remove_SubTree ou CM_Query_And_Remove_SubTree_Ex e especificando o sinalizador CM_REMOVE_NO_RESTART.
Valor retornado
Se a operação for bem-sucedida, a função retornará CR_SUCCESS. Caso contrário, ele retornará um dos códigos de erro com o prefixo "CR_" definido em Cfgmgr32.h.
Comentários
Os aplicativos de instalação do dispositivo devem usar a solicitação DIF_PROPERTYCHANGE para reiniciar um dispositivo em vez de usar essa função. A solicitação DIF_PROPERTYCHANGE pode ser usada para habilitar, desabilitar, reiniciar, parar ou alterar as propriedades de um dispositivo.
Se uma instância de dispositivo não tiver um problema e já estiver iniciada, CM_Setup_DevNode retornará sem alterar o status da instância do dispositivo.
Chame CM_Get_DevNode_Status ou CM_Get_DevNode_Status_Ex para determinar a status e o código de problema de uma instância do dispositivo.
Requisitos
| 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 |