Función SetupInitDefaultQueueCallbackEx (setupapi.h)

  • Artículo

[Esta función está disponible para su uso en los sistemas operativos indicados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. SetupAPI ya no debe usarse para instalar aplicaciones. En su lugar, use Windows Installer para desarrollar instaladores de aplicaciones. SetupAPI sigue usándose para instalar controladores de dispositivos.

La función SetupInitDefaultQueueCallbackEx inicializa el contexto utilizado por la rutina de devolución de llamada de cola predeterminada incluida con la API de instalación de la misma manera que SetupInitDefaultQueueCallback, salvo que se proporciona una ventana adicional a la función de devolución de llamada para aceptar mensajes de progreso.

Sintaxis

WINSETUPAPI PVOID SetupInitDefaultQueueCallbackEx(
  [in] HWND  OwnerWindow,
  [in] HWND  AlternateProgressWindow,
  [in] UINT  ProgressMessage,
  [in] DWORD Reserved1,
  [in] PVOID Reserved2
);

Parámetros

[in] OwnerWindow

Identificador de la ventana que se va a usar como elemento primario de los cuadros de diálogo generados por la rutina de devolución de llamada predeterminada.

[in] AlternateProgressWindow

Identificador de una ventana que recibe los mensajes de progreso. Para evitar que se muestren los mensajes de progreso, puede especificar este parámetro que se va a INVALID_HANDLE_VALUE.

[in] ProgressMessage

Mensaje que se envía a AlternateProgressWindow cuando se inicia la cola de copia y cada vez que se copia un archivo.

[in] Reserved1

Primer parámetro de mensaje que se envía a AlternateProgressWindow mediante la rutina de devolución de llamada predeterminada.

[in] Reserved2

Segundo parámetro de mensaje que se envía a AlternateProgressWindow mediante la rutina de devolución de llamada predeterminada.

Valor devuelto

SetupInitDefaultQueueCallbackEx devuelve un puntero al contexto utilizado por la rutina de devolución de llamada de cola predeterminada. Esta función solo puede producir un error si no hay memoria suficiente. Si se produce un error en esta función, devuelve NULL y no establece el último código de error para el subproceso.

Comentarios

Cuando la cola comienza a confirmar la subconsulta de copia, la rutina de devolución de llamada de cola predeterminada envía un mensaje a la ventana especificada en AlternateProgressWindow. Reserved1 tiene el valor 0 y Reserved2 contiene un puntero al número de operaciones de copia de archivos en cola.

Para cada operación de copia de archivos completada, la rutina de devolución de llamada de cola predeterminada envía un mensaje a AlternateProgressWindow, que se puede usar para "marcar" la barra de progreso. Reserved1 tiene el valor 1 y Reserved2 es cero.

SetupInitDefaultQueueCallbackEx se puede usar para obtener el comportamiento predeterminado para la solicitud de disco, el control de errores, etc., y también proporcionar un medidor incrustado en una página del asistente u otro cuadro de diálogo especializado.

Independientemente de si inicializó el contexto utilizado por la rutina de devolución de llamada de cola predeterminada con SetupInitDefaultQueueCallback o SetupInitDefaultQueueCallbackEx, después de que las operaciones en cola hayan terminado de procesarse, llame a SetupTermDefaultQueueCallback para liberar los recursos asignados en la inicialización de la estructura de contexto. Para obtener más información, vea Inicialización y finalización del contexto de devolución de llamada.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado setupapi.h
Library Setupapi.lib
Archivo DLL Setupapi.dll
Conjunto de API ext-ms-win-setupapi-classinstallers-l1-1-2 (introducido en Windows 10, versión 10.0.14393)

Vea también

Funciones

Información general

SetupInitDefaultQueueCallback