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

Vedi anche

Funzioni

Panoramica

SetupInitDefaultQueueCallback