Función SetupDiInstallClassExW (setupapi.h)
La función SetupDiInstallClassEx instala un instalador de clase o una clase de interfaz.
Sintaxis
WINSETUPAPI BOOL SetupDiInstallClassExW(
[in, optional] HWND hwndParent,
[in, optional] PCWSTR InfFileName,
[in] DWORD Flags,
[in, optional] HSPFILEQ FileQueue,
[in, optional] const GUID *InterfaceClassGuid,
PVOID Reserved1,
PVOID Reserved2
);
Parámetros
[in, optional] hwndParent
Identificador de la ventana primaria de cualquier interfaz de usuario que se use para instalar esta clase. Este parámetro es opcional y puede ser NULL.
[in, optional] InfFileName
Puntero a una cadena terminada en NULL que contiene el nombre de un archivo INF. Este parámetro es opcional y puede ser NULL. Si esta función se usa para instalar un instalador de clase, el archivo INF contiene una sección INF ClassInstall32 y este parámetro no debe ser NULL.
Si esta función se usa para instalar una clase de interfaz, el archivo INF contiene una sección INF InterfaceInstall32.
[in] Flags
Valor de tipo DWORD que controla el proceso de instalación. Las marcas pueden ser cero o un OR bit a bit de los siguientes valores:
DI_NOVCP
Establezca esta marca si se proporciona FileQueue .
DI_NOVCP indica a la función SetupInstallFromInfSection que no cree una cola propia y use en su lugar la cola proporcionada por el autor de la llamada.
Si se establece esta marca, los archivos no se copian simplemente en cola.
Para obtener más información sobre la función SetupInstallFromInfSection, consulte la documentación de Microsoft Windows SDK.
DI_NOBROWSE
Establezca esta marca para deshabilitar la exploración si una operación de copia no encuentra un archivo especificado. Si el autor de la llamada proporciona una cola de archivos, se omite esta marca.
DI_FORCECOPY
Establezca esta marca en copiar siempre los archivos, incluso si ya están presentes en el equipo del usuario. Si el autor de la llamada proporciona una cola de archivos, se omite esta marca.
DI_QUIETINSTALL
Establezca esta marca para suprimir la interfaz de usuario a menos que sea absolutamente necesario. Por ejemplo, no muestre el cuadro de diálogo de progreso. Si el autor de la llamada proporciona una cola de archivos, se omite esta marca.
[in, optional] FileQueue
Si se establece la marca de DI_NOVCP, este parámetro proporciona un identificador a una cola de archivos donde las operaciones de archivo se deben poner en cola pero no confirmarse.
[in, optional] InterfaceClassGuid
Puntero a un GUID que identifica la clase de interfaz que se va a instalar. Este parámetro es opcional y puede ser NULL. Si se especifica este parámetro, esta función se usa para instalar la clase de interfaz representada por el GUID. Si este parámetro es NULL, esta función se usa para instalar un instalador de clase.
Reserved1
Reservado. Debe ser cero.
Reserved2
Reservado. Debe ser cero.
Valor devuelto
SetupDiInstallClassEx devuelve TRUE si se realiza correctamente. De lo contrario, devuelve FALSE y el error registrado se puede recuperar con una llamada a GetLastError.
Comentarios
El autor de la llamada de esta función debe ser miembro del grupo Administradores.
El instalador de clase suele llamar a SetupDiInstallClassEx para instalar una nueva clase de configuración de dispositivo o una nueva clase de interfaz de dispositivo.
Nota
El encabezado setupapi.h define SetupDiInstallClassEx 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
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 |