Funzione SetupCommitFileQueueA (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 SetupCommitFileQueue esegue operazioni sui file accodate in una coda di file di installazione.
La procedura consigliata consiste nel raccogliere tutte le operazioni di file necessarie per la coda di file ed eseguire il commit della coda una sola volta perché una coda di file non può essere riutilizzata dopo il commit. Se dopo il commit è necessaria un'ulteriore elaborazione della coda, l'handle per la coda deve essere chiuso e una nuova coda di file creata. Per altre informazioni, vedere Commit di una coda.
Se un file viene modificato, il chiamante di questa funzione ha i privilegi per scrivere nella directory di destinazione.
Sintassi
WINSETUPAPI BOOL SetupCommitFileQueueA(
[in] HWND Owner,
[in] HSPFILEQ QueueHandle,
[in] PSP_FILE_CALLBACK_A MsgHandler,
[in] PVOID Context
);
Parametri
[in] Owner
Handle facoltativo in una finestra da utilizzare come elemento padre di qualsiasi finestra di dialogo di stato.
[in] QueueHandle
Gestire in una coda di file di installazione, come restituito da SetupOpenFileQueue.
[in] MsgHandler
Puntatore a una routine di callback facoltativa per ricevere una notifica di vari eventi significativi presenti nell'elaborazione della coda. Per altre informazioni, vedere Routine di callback coda predefinita o FileCallback Se la routine di callback è null, SetupCommitFileQueue restituisce TRUE e l'errore è 0 o NO_ERROR.
[in] Context
Valore passato alla funzione di callback fornita dal parametro MsgHandler . Se la routine di callback predefinita è stata specificata come MsgHandler, questo contesto deve essere il contesto restituito da SetupInitDefaultQueueCallback o SetupInitDefaultQueueCallbackEx.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
La routine di callback specificata in MsgHandler deve essere compatibile con i parametri passati da SetupCommitFileQueue durante un commit della coda.
Se Unicode è definito nell'applicazione di callback e si specifica MsgHandler come routine di callback della coda predefinita, la routine di callback prevede parametri Unicode. In caso contrario, la routine di callback della coda predefinita prevede parametri ANSI.
Nota
L'intestazione setupapi.h definisce SetupCommitFileQueue 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 |