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

Confira também

SetupDiCreateDeviceInfo

SetupDiEnumDeviceInfo

SetupDiGetWizardPage

SetupDiOpenDeviceInfo