Função SetupDiDeleteDevRegKey (setupapi.h)

  • Artigo

A função SetupDiDeleteDevRegKey exclui as chaves do Registro acessíveis ao usuário especificadas associadas a um elemento de informações do dispositivo.

Sintaxe

WINSETUPAPI BOOL SetupDiDeleteDevRegKey(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData,
  [in] DWORD            Scope,
  [in] DWORD            HwProfile,
  [in] DWORD            KeyType
);

Parâmetros

[in] DeviceInfoSet

Um identificador para o conjunto de informações do dispositivo que contém um elemento de informações do dispositivo que representa o dispositivo para o qual excluir chaves do Registro. O conjunto de informações do dispositivo não deve conter elementos remotos.

[in] DeviceInfoData

Um ponteiro para uma estrutura SP_DEVINFO_DATA que especifica o elemento de informações do dispositivo em DeviceInfoSet.

[in] Scope

O escopo da chave do Registro a ser excluída. O escopo indica onde as informações estão localizadas. A chave pode ser global ou específica do perfil de hardware. Pode ser um dos seguintes valores:

DICS_FLAG_GLOBAL

Exclua a chave que armazena informações de configuração global.

DICS_FLAG_CONFIGSPECIFIC

Exclua a chave que armazena informações de configuração específicas do perfil de hardware.

[in] HwProfile

Se Scope for definido como DICS_FLAG_CONFIGSPECIFIC, o parâmetro HwProfile especificará o perfil de hardware para o qual excluir a chave do Registro. Se HwProfile for 0, a chave do perfil de hardware atual será excluída. Se HwProfile for 0xFFFFFFFF, a chave do Registro para todos os perfis de hardware será excluída.

[in] KeyType

O tipo de chave de armazenamento do Registro a ser excluída. Pode ser um dos seguintes valores:

DIREG_DEV

Exclua a chave de hardware do dispositivo.

DIREG_DRV

Exclua a chave de software do dispositivo.

DIREG_BOTH

Exclua as chaves de hardware e software do dispositivo.

Valor retornado

A função retornará TRUE se for bem-sucedida. Caso contrário, ele retornará FALSE e o erro registrado poderá ser recuperado com uma chamada para GetLastError.

Comentários

O chamador dessa função deve ser um membro do grupo Administradores.

O DeviceInfoSet deve conter apenas elementos no computador local.

Requisitos

   
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 setupapi.h (inclua Setupapi.h)
Biblioteca Setupapi.lib
DLL Setupapi.dll

Confira também

SetupDiCreateDevRegKey

SetupDiGetHwProfileList