Función SetupDiInstallClassA (setupapi.h)
La función SetupDiInstallClass instala la sección ClassInstall32 del archivo INF especificado.
Sintaxis
WINSETUPAPI BOOL SetupDiInstallClassA(
[in, optional] HWND hwndParent,
[in] PCSTR InfFileName,
[in] DWORD Flags,
[in, optional] HSPFILEQ FileQueue
);
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] InfFileName
Puntero a una cadena terminada en NULL que contiene el nombre del archivo INF que contiene una sección ClassInstall32 inf.
[in] Flags
Estas marcas controlan el proceso de instalación. Puede ser una combinación de lo siguiente:
DI_NOVCP
Establezca esta marca si se proporciona FileQueue . DI_NOVCP indica a la función SetupInstallFromInfSection (descrita en Microsoft Windows SDK documentación) que no cree una cola propia y que 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.
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 DI_NOVCP, este parámetro proporciona un identificador a una cola de archivos donde se deben poner en cola las operaciones de archivo, pero no confirmarse.
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
El autor de la llamada de esta función debe ser miembro del grupo Administradores.
Un instalador de clase llama a esta función cuando instala un dispositivo de una nueva clase de dispositivo.
Para instalar una clase de interfaz o una clase de dispositivo, use SetupDiInstallClassEx.
Nota
El encabezado setupapi.h define SetupDiInstallClass 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 |