Creazione di una coda e operazioni di accodamento dei file

L'accodamento delle operazioni sui file è utile perché consente di elaborare l'installazione nel suo complesso, anziché per sezioni INF.

Per creare una coda di file, dichiarare una variabile per archiviare l'handle della coda, quindi chiamare la funzione SetupOpenFileQueue. Dopo aver creato la coda, è possibile accodare le operazioni di copia, ridenominazione ed eliminazione, nonché analizzare la coda di file per verificare le operazioni accodate.

Per aggiungere operazioni su singolo file alla coda, usare le funzioni diSetupQueueCopy, SetupQueueRenamee le funzioni di SetupQueueDelete.

Tutte le operazioni sui file elencate in una sezione Copy Files, Delete Fileso Rename Files possono essere aggiunte alla coda usando SetupQueueCopySection, SetupQueueDeleteSectiono SetupQueueRenameSection.

Un altro modo per accodare tutti i file nelle sezioni Copia file elencati in una sezione Install di un INF consiste nell'usare la funzione SetupInstallFilesFromInfSection.

Nell'esempio seguente viene utilizzata la funzioneSetupQueueCopySection per accodare le operazioni di copia per tutti i file elencati in una sezione Copia file di un file INF.

test = SetupQueueCopySection(
     MyQueue,                  \\Handle to the open queue
     "A:\",                    \\Source root path
     MyInf,                    \\Inf containing the source info
     NULL,                     \\specifies that MyInf contains 
                               \\  the section to copy as well
     MySection,                \\the name of the section to queue
  
                               \\flags specifying the copy style
     SP_COPY_NOSKIP | SP_COPY_NOBROWSE,
);

Nell'esempio MyQueue è la coda a cui aggiungere operazioni di copia, "A:\" specifica il percorso dell'origine e MyInf è l'handle per il file INF aperto. Il parametro ListInfHandle è impostato su NULL, a indicare che la sezione per la copia è in MyInf. MySection è la sezione in MyInf contenente i file da copiare.

Le flag SP_COPY_NOSKIP e SP_COPY_NOBROWSE sono state combinate usando un operatore OR per indicare che non devono essere offerte all'utente opzioni per ignorare o cercare i file in caso di errori.