Funzione SetupDefaultQueueCallbackA (setupapi.h)

  • Articolo

[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