Compartilhar via


Função CM_Disable_DevNode (cfgmgr32.h)

A função CM_Disable_DevNode desabilita um dispositivo.

Sintaxe

CMAPI CONFIGRET CM_Disable_DevNode(
  [in] DEVINST dnDevInst,
  [in] ULONG   ulFlags
);

Parâmetros

[in] dnDevInst

Identificador de instância do dispositivo associado ao computador local.

[in] ulFlags

Desabilitar sinalizadores:

CM_DISABLE_UI_NOT_OK

Não exiba nenhuma interface para o usuário se a tentativa de desabilitar o dispositivo falhar.

CM_DISABLE_PERSIST

Desabilita o dispositivo entre reinicializações.

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

Por padrão, CM_Disable_DevNode desabilita um dispositivo ao mesmo tempo, mas após a reinicialização o dispositivo é habilitado novamente. Começando no Windows 10, você pode especificar o sinalizador CM_DISABLE_PERSIST para desabilitar o dispositivo entre reinicializações.

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_Enable_DevNode

DIF_PROPERTYCHANGE

SetupDiCallClassInstaller