função CM_Uninstall_DevNode (cfgmgr32.h)

  • Artigo

A função CM_Uninstall_DevNode remove todo o estado persistente associado a uma instância do dispositivo.

Sintaxe

CMAPI CONFIGRET CM_Uninstall_DevNode(
  [in] DEVNODE dnDevInst,
  [in] ULONG   ulFlags
);

Parâmetros

[in] dnDevInst

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

[in] ulFlags

Reservado. Deve ser definido como zero.

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 prefixados por CR_ definidos em Cfgmgr32.h.

Comentários

Essa função desinstala o dispositivo sem enviar uma solicitação IRP_MN_QUERY_REMOVE_DEVICE ou chamar instaladores de classe ou co-instaladores. Se o aplicativo for executado somente em uma Plataforma de Destino da Área de Trabalho, em vez de chamar CM_Uninstall_DevNode, o aplicativo deverá desinstalar o dispositivo chamando SetupDiCallClassInstaller com o código DIF_REMOVE ou chamando DiUninstallDevice.

Use a seguinte sequência para chamar essa função:

  1. Verifique se CM_Get_DevNode_Status retorna êxito. Isso significa que o dispositivo está presente.
  2. Se o dispositivo estiver presente, chame CM_Query_And_Remove_SubTree.
  3. Chame CM_Uninstall_DevNode.

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

Confira também

SetupDiCallClassInstaller