função CM_Setup_DevNode (cfgmgr32.h)

Artigo
08/22/2023

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