Función SetupDiCreateDeviceInfoListExA (setupapi.h)
La función SetupDiCreateDeviceInfoList crea un conjunto de información de dispositivo vacío en un equipo remoto o local y, opcionalmente, asocia el conjunto a una clase de configuración de dispositivo .
Sintaxis
WINSETUPAPI HDEVINFO SetupDiCreateDeviceInfoListExA(
[in, optional] const GUID *ClassGuid,
[in, optional] HWND hwndParent,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Parámetros
[in, optional] ClassGuid
Puntero al GUID de la clase de configuración del dispositivo que se va a asociar al conjunto de información del dispositivo recién creado. Si se especifica este parámetro, solo se pueden incluir dispositivos de esta clase en este conjunto de información del dispositivo. Si este parámetro se establece en NULL, el conjunto de información del dispositivo no está asociado a una clase de configuración de dispositivo específica.
[in, optional] hwndParent
Identificador de la ventana de nivel superior que se va a usar para cualquier interfaz de usuario relacionada con acciones no específicas del dispositivo (por ejemplo, un cuadro de diálogo seleccionar dispositivo que usa la lista de controladores de clase global). Este identificador es opcional y se puede NULL. Si no se requiere una ventana de nivel superior específica, establezca hwndParent en NULL.
[in, optional] MachineName
Puntero a una cadena terminada en NULL que contiene el nombre de un equipo de una red. Si se especifica un nombre, solo se pueden crear y abrir dispositivos en ese equipo en este conjunto de información del dispositivo. Si este parámetro se establece en NULL, el conjunto de información del dispositivo es para los dispositivos del equipo local.
Cautela
No se admite el uso de esta función para acceder a máquinas remotas a partir de Windows 8 y Windows Server 2012, ya que esta funcionalidad se ha quitado.
Reserved
Debe ser null.
Valor devuelto
La función devuelve un identificador a un conjunto de información de dispositivo vacío si se realiza correctamente. De lo contrario, devuelve INVALID_HANDLE_VALUE. Para obtener información de error extendida, llame a GetLastError.
Observaciones
El autor de la llamada de esta función debe eliminar la información de dispositivo devuelta cuando ya no sea necesaria llamando a SetupDiDestroyDeviceInfoList.
Si el conjunto de información del dispositivo es para dispositivos de un equipo remoto (MachineName no es NULL), todas las operaciones posteriores de este conjunto o cualquiera de sus elementos deben usar rutinas que admitan conjuntos de información del dispositivo con elementos remotos. Las rutinas SetupDiXxx que no proporcionan esta compatibilidad, como SetupDiCallClassInstaller, tienen una instrucción para ese efecto en su página de referencia.
Nota
El encabezado setupapi.h define SetupDiCreateDeviceInfoListEx como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
| de la plataforma de destino de |
Escritorio |
| encabezado de |
setupapi.h (incluya Setupapi.h) |
| biblioteca de |
Setupapi.lib |