Función SetupDiInstallClassW (setupapi.h)

  • Artículo

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 puede ser 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 Microsoft Windows SDK documentación) 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.

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.

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 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

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

SetupDiCallClassInstaller

SetupDiInstallClassEx