Funzione SetupCommitFileQueueA (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 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é non è possibile riutilizzare una coda di file dopo il commit. Se è necessaria un'ulteriore elaborazione della coda dopo il commit, 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 deve disporre dei 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 per 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 della 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

La routine di callback specificata in MsgHandler deve essere compatibile con i parametri che SetupCommitFileQueue passati 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 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

Vedere anche

Funzioni

panoramica

SetupCloseFileQueue

Condividi tramite