Función SetupDiInstallClassW (setupapi.h)
La función SetupDiInstallClass instala la sección ClassInstall32 del archivo INF especificado.
Sintaxis
WINSETUPAPI BOOL SetupDiInstallClassW(
[in, optional] HWND hwndParent,
[in] PCWSTR 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 se puede NULL.
[in] InfFileName
Puntero a una cadena terminada en NULL que contiene el nombre del archivo INF que contiene una sección INF ClassInstall32.
[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 la documentación de Microsoft Windows SDK) no crear una cola propia y usar la cola proporcionada por el autor de la llamada en su lugar. Si se establece esta marca, los archivos no se copian solo 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 ejecuta correctamente. De lo contrario, devuelve false y el error registrado se puede recuperar con una llamada a GetLastError.
Observaciones
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 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 |