Funzione SetupDefaultQueueCallbackA (setupapi.h)

Articolo
11/20/2024

[Questa funzione è disponibile per l'uso nei sistemi operativi indicati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive. SetupAPI non deve più essere usata 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 setupDefaultQueueCallback è la routine di callback della coda predefinita inclusa nell'API di installazione. È possibile usarlo per elaborare le notifiche inviate dalla funzione SetupCommitFileQueue.

Sintassi

WINSETUPAPI UINT SetupDefaultQueueCallbackA(
  [in] PVOID    Context,
  [in] UINT     Notification,
  [in] UINT_PTR Param1,
  [in] UINT_PTR Param2
);

Parametri

[in] Context

Puntatore al contesto inizializzato dalle funzioni di SetupInitDefaultQueueCallback o SetupInitDefaultQueueCallbackEx.

[in] Notification

Notifica di un'azione della coda. Questo parametro può essere uno dei valori illustrati nella tabella seguente.

Valore	Significato
SPFILENOTIFY_STARTQUEUE	Operazioni di file in coda avviate.
SPFILENOTIFY_ENDQUEUE	Operazioni di file in coda completate.
SPFILENOTIFY_STARTSUBQUEUE	Avviare una copia, rinominare o eliminare una coda secondaria.
SPFILENOTIFY_ENDSUBQUEUE	È stata completata una copia, ridenominazione o eliminazione della sottoquery.
SPFILENOTIFY_STARTRENAME	È stata avviata un'operazione di ridenominazione.
SPFILENOTIFY_ENDRENAME	Operazione di ridenominazione completata.
SPFILENOTIFY_RENAMEERROR	Errore durante la ridenominazione di un file.
SPFILENOTIFY_STARTDELETE	È stata avviata un'operazione di eliminazione.
SPFILENOTIFY_ENDDELETE	Operazione di eliminazione completata.
SPFILENOTIFY_DELETEERROR	Errore durante l'eliminazione di un file.
SPFILENOTIFY_STARTCOPY	È stata avviata un'operazione di copia.
SPFILENOTIFY_ENDCOPY	Operazione di copia completata.
SPFILENOTIFY_COPYERROR	Errore durante la copia di un file.
SPFILENOTIFY_NEEDMEDIA	Sono necessari nuovi supporti.
SPFILENOTIFY_LANGMISMATCH	Il file di destinazione esistente si trova in una lingua diversa rispetto all'origine.
SPFILENOTIFY_TARGETEXISTS	File di destinazione esistente.
SPFILENOTIFY_TARGETNEWER	Il file di destinazione esistente è più recente rispetto all'origine.

[in] Param1

Informazioni aggiuntive sul messaggio. Il contenuto di questo parametro dipende dal valore del parametro Notification.

[in] Param2

Informazioni aggiuntive sul messaggio. Il contenuto di questo parametro dipende dal valore del parametro Notification.

Valore restituito

Restituisce un intero senza segno per SetupCommitFileQueue che può essere quello dei valori illustrati nella tabella seguente.

Codice restituito	Descrizione
FILEOP_ABORT	Interrompe l'operazione.
FILEOP_DOIT	Esegue l'operazione di file.
FILEOP_SKIP	Ignora l'operazione.
FILEOP_RETRY	Ritenta l'operazione.
FILEOP_NEWPATH	Ottiene un nuovo percorso per l'operazione.

Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

La funzione SetupDefaultQueueCallback viene in genere chiamata in modo esplicito solo da una routine di callback della coda personalizzata. Il callback personalizzato gestisce un subset delle notifiche di commit della coda e chiama la funzione SetupDefaultQueueCallback per gestire il resto delle notifiche.

Per altre informazioni, vedere Queue Notifications.

Nota

L'intestazione setupapi.h definisce SetupDefaultQueueCallback come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
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)

Vedere anche

Funzioni

panoramica

SetupCommitFileQueue

Condividi tramite