Função SetupDiDeleteDeviceInfo (setupapi.h)
A função SetupDiDeleteDeviceInfo exclui um elemento de informações do dispositivo de um conjunto de informações do dispositivo. Essa função não exclui o dispositivo real.
Sintaxe
WINSETUPAPI BOOL SetupDiDeleteDeviceInfo(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData
);
Parâmetros
[in] DeviceInfoSet
Um identificador para o conjunto de informações do dispositivo que contém o elemento de informações do dispositivo a ser excluído.
[in] DeviceInfoData
Um ponteiro para uma estrutura SP_DEVINFO_DATA que representa o elemento de informações do dispositivo em DeviceInfoSet a ser excluído.
Retornar valor
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
Se o elemento de informações do dispositivo especificado estiver em uso (por exemplo, por uma página do assistente), a função falhará. Nesse caso, uma chamada para GetLastError retorna ERROR_DEVINFO_DATA_LOCKED. Isso acontece se um identificador de uma página do assistente é recuperado com uma chamada para SetupDiGetWizardPage com esse elemento de informações do dispositivo especificado e o sinalizador DIWP_FLAG_USE_DEVINFO_DATA definido. Para excluir esse elemento de informações do dispositivo, primeiro feche o identificador HPROPSHEETPAGE do assistente.
Requisitos
| Requisito | Valor |
|---|---|
| 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 |