Funzione SetupDefaultQueueCallbackA (setupapi.h)

Articolo
03/01/2024

[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 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 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 dei 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	Si è verificato un errore durante la ridenominazione di un file.
SPFILENOTIFY_STARTDELETE	È stata avviata un'operazione di eliminazione.
SPFILENOTIFY_ENDDELETE	Operazione di eliminazione completata.
SPFILENOTIFY_DELETEERROR	Si è verificato un errore durante l'eliminazione di un file.
SPFILENOTIFY_STARTCOPY	È stata avviata un'operazione di copia.
SPFILENOTIFY_ENDCOPY	Operazione di copia completata.
SPFILENOTIFY_COPYERROR	Si è verificato un 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 dell'origine.

[in] Param1

Informazioni aggiuntive sui messaggi. Il contenuto di questo parametro dipende dal valore del parametro Notification .

[in] Param2

Informazioni aggiuntive sui messaggi. Il contenuto di questo parametro dipende dal valore del parametro Notification .

Valore restituito

Restituisce un intero senza segno a 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 informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

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 Notifiche code.

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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
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)

Vedi anche

Funzioni

Panoramica

SetupCommitFileQueue

Condividi tramite