Función SetupDiSetDeviceInterfaceDefault (setupapi.h)
La función SetupDiSetDeviceInterfaceDefault establece una interfaz de dispositivo como interfaz predeterminada para una clase de interfaz de dispositivo.
Sintaxis
WINSETUPAPI BOOL SetupDiSetDeviceInterfaceDefault(
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
[in] DWORD Flags,
PVOID Reserved
);
Parámetros
[in] DeviceInfoSet
Identificador del conjunto de información del dispositivo que contiene la interfaz de dispositivo que se va a establecer como valor predeterminado para una clase de interfaz de dispositivo.
[in, out] DeviceInterfaceData
Puntero a una estructura de SP_DEVICE_INTERFACE_DATA que especifica la interfaz del dispositivo en DeviceInfoSet.
[in] Flags
No se usa, debe ser cero.
Reserved
Reservado para uso futuro, debe ser NULL.
Valor devuelto
La función devuelve TRUE si se realiza correctamente. De lo contrario, devuelve FALSE y el error registrado se puede recuperar con una llamada a GetLastError.
Comentarios
Un llamador debe tener privilegios de administrador para establecer la interfaz predeterminada para una clase de interfaz de dispositivo. Sin embargo, si la interfaz predeterminada solicitada es la misma que la interfaz predeterminada establecida actualmente, la función devuelve TRUE independientemente de si el autor de la llamada tiene privilegios de administrador.
Si la función establece correctamente la interfaz de dispositivo especificada como predeterminada para la clase de dispositivo, actualiza el miembro Flags de la estructura de SP_DEVICE_INTERFACE_DATA proporcionada.
Llame a SetupDiGetClassDevs para obtener un identificador DevInfoSet a un conjunto de información del dispositivo que contiene la interfaz de dispositivo que se va a establecer como valor predeterminado para una clase de interfaz de dispositivo. Para obtener el puntero DeviceInterfaceData al elemento de interfaz del dispositivo, llame a SetupDiEnumDeviceInterfaces para enumerar las interfaces del conjunto de información del dispositivo. Para recuperar información sobre una interfaz enumerada, llame a SetupDiGetDeviceInterfaceDetail.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows XP y versiones posteriores de Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | setupapi.h (incluya Setupapi.h) |
| Library | Setupapi.lib |
| Archivo DLL | Setupapi.dll |