Funzione SetupInitDefaultQueueCallbackEx (setupapi.h)
[Questa funzione è disponibile per l'uso nei sistemi operativi indicati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. SetupAPI non deve più essere usato per l'installazione di applicazioni. Usare invece Windows Installer per lo sviluppo di programmi di installazione delle applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.
La funzione SetupInitDefaultQueueCallbackEx inizializza il contesto utilizzato dalla routine di callback della coda predefinita inclusa nell'API di installazione allo stesso modo di SetupInitDefaultQueueCallback, ad eccezione del fatto che viene fornita una finestra aggiuntiva alla funzione di callback per accettare i messaggi di stato.
Sintassi
WINSETUPAPI PVOID SetupInitDefaultQueueCallbackEx(
[in] HWND OwnerWindow,
[in] HWND AlternateProgressWindow,
[in] UINT ProgressMessage,
[in] DWORD Reserved1,
[in] PVOID Reserved2
);
Parametri
[in] OwnerWindow
Handle per la finestra da utilizzare come elemento padre di qualsiasi finestra di dialogo generata dalla routine di callback predefinita.
[in] AlternateProgressWindow
Gestire in una finestra che riceve i messaggi di stato. Per impedire la visualizzazione dei messaggi di stato, è possibile specificare questo parametro da INVALID_HANDLE_VALUE.
[in] ProgressMessage
Messaggio inviato a AlternateProgressWindow all'avvio della coda di copia e ogni volta che viene copiato un file.
[in] Reserved1
Primo parametro del messaggio inviato alla routine di callback AlternateProgressWindow .
[in] Reserved2
Secondo parametro del messaggio inviato alla routine di callback AlternateProgressWindow .
Valore restituito
SetupInitDefaultQueueCallbackEx restituisce un puntatore al contesto utilizzato dalla routine di callback della coda predefinita. Questa funzione può avere esito negativo solo se la memoria non è sufficiente. Se questa funzione ha esito negativo, restituisce NULL e non imposta l'ultimo codice di errore per il thread.
Commenti
Quando la coda inizia a eseguire il commit della coda secondaria di copia, la routine di callback della coda predefinita invia un messaggio alla finestra specificata in AlternateProgressWindow. Reserved1 ha il valore 0 e Reserved2 contiene un puntatore al numero di operazioni di copia file accodate.
Per ogni operazione di copia file completata, la routine di callback della coda predefinita invia un messaggio a AlternateProgressWindow, che può essere usato per "tick" sulla barra di stato. Reserved1 ha il valore 1 e Reserved2 è zero.
SetupInitDefaultQueueCallbackEx può essere usato per ottenere il comportamento predefinito per la richiesta del disco, la gestione degli errori e così via, nonché fornire un misuratore incorporato in una pagina della procedura guidata o in un'altra finestra di dialogo specializzata.
Indipendentemente dal fatto che il contesto sia stato inizializzato dalla routine di callback della coda predefinita con SetupInitDefaultQueueCallback o SetupInitDefaultQueueCallbackEx, dopo che le operazioni in coda hanno terminato l'elaborazione, chiamare SetupTermDefaultQueueCallback per rilasciare le risorse allocate durante l'inizializzazione della struttura del contesto. Per altre informazioni, vedere Inizializzazione e terminazione del contesto di callback.
Requisiti
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | setupapi.h |
| Libreria | Setupapi.lib |
| DLL | Setupapi.dll |
| Set di API | ext-ms-win-setupapi-classinstallers-l1-1-2 (introdotto in Windows 10, versione 10.0.14393) |