Função SetupDiSetDeviceInterfaceDefault (setupapi.h)
A função SetupDiSetDeviceInterfaceDefault define uma interface do dispositivo como a interface padrão para uma classe de interface do dispositivo.
Sintaxe
WINSETUPAPI BOOL SetupDiSetDeviceInterfaceDefault(
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
[in] DWORD Flags,
PVOID Reserved
);
Parâmetros
[in] DeviceInfoSet
Um identificador para o conjunto de informações do dispositivo que contém a interface do dispositivo a ser definida como o padrão para uma classe de interface do dispositivo.
[in, out] DeviceInterfaceData
Um ponteiro para uma estrutura SP_DEVICE_INTERFACE_DATA que especifica a interface do dispositivo em DeviceInfoSet.
[in] Flags
Não usado, deve ser zero.
Reserved
Reservado para uso futuro, deve ser NULL.
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
Um chamador deve ter privilégios de Administrador para definir a interface padrão para uma classe de interface do dispositivo. No entanto, se a interface padrão solicitada for a mesma que a interface padrão definida no momento, a função retornará TRUE , independentemente de o chamador ter privilégios de Administrador.
Se a função definir com êxito a interface do dispositivo especificada como o padrão para a classe de dispositivo, ela atualizará o membro Flags da estrutura de SP_DEVICE_INTERFACE_DATA fornecida.
Chame SetupDiGetClassDevs para obter um identificador DevInfoSet para um conjunto de informações do dispositivo que contém a interface do dispositivo a ser definida como o padrão para uma classe de interface do dispositivo. Para obter o ponteiro DeviceInterfaceData para o elemento de interface do dispositivo, chame SetupDiEnumDeviceInterfaces para enumerar as interfaces no conjunto de informações do dispositivo. Para recuperar informações sobre uma interface enumerada, chame SetupDiGetDeviceInterfaceDetail.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows XP 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 |