Função SetupDiDeleteDevRegKey (setupapi.h)
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 |