Función SetupDiCreateDeviceInfoListExW (setupapi.h)

  • Artículo

La función SetupDiCreateDeviceInfoList crea una información de dispositivo vacía establecida en un equipo remoto o local y, opcionalmente, asocia el conjunto a una clase de configuración de dispositivo .

Sintaxis

WINSETUPAPI HDEVINFO SetupDiCreateDeviceInfoListExW(
  [in, optional] const GUID *ClassGuid,
  [in, optional] HWND       hwndParent,
  [in, optional] PCWSTR     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 global de controladores de clase). Este identificador es opcional y puede ser 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.

Precaución

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.

Comentarios

El autor de la llamada de esta función debe eliminar la información de dispositivo devuelta establecida cuando ya no sea necesaria mediante una llamada a SetupDiDestroyDeviceInfoList.

Si el conjunto de información del dispositivo es para los 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 Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino Escritorio
Encabezado setupapi.h (incluya Setupapi.h)
Library Setupapi.lib

Consulte también

SetupDiCreateDeviceInfoList

SetupDiDestroyDeviceInfoList

SetupDiGetDeviceInfoListDetail