Función SetupDiInstallClassExA (setupapi.h)

  • Artículo

La función SetupDiInstallClassEx instala un instalador de clase o una clase de interfaz.

Sintaxis

WINSETUPAPI BOOL SetupDiInstallClassExA(
  [in, optional] HWND       hwndParent,
  [in, optional] PCSTR      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 También se puede instalar automáticamente una clase de interfaz llamando a SetupDiInstallDeviceInterfaces para instalar las interfaces de dispositivo de un 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

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

SetupDiInstallDeviceInterfaces