Funzione SetupQueueCopyW (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 di applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.

La funzione SetupQueueCopy aggiunge un'unica operazione di copia file a una coda di file di installazione.

Sintassi

WINSETUPAPI BOOL SetupQueueCopyW(
  [in] HSPFILEQ QueueHandle,
  [in] PCWSTR   SourceRootPath,
  [in] PCWSTR   SourcePath,
  [in] PCWSTR   SourceFilename,
  [in] PCWSTR   SourceDescription,
  [in] PCWSTR   SourceTagfile,
  [in] PCWSTR   TargetDirectory,
  [in] PCWSTR   TargetFilename,
  [in] DWORD    CopyStyle
);

Parametri

[in] QueueHandle

Gestire una coda di file di installazione, come restituito da SetupOpenFileQueue.

[in] SourceRootPath

Puntatore a una stringa con terminazione null che specifica la radice dell'origine per questa copia, ad esempio A:.

[in] SourcePath

Puntatore a una stringa con terminazione null che specifica il percorso relativo a SourceRootPath in cui è possibile trovare il file. Questo parametro può essere NULL.

[in] SourceFilename

Puntatore a una stringa con terminazione null che specifica la parte del nome file del file da copiare.

[in] SourceDescription

Puntatore a una stringa con terminazione null che specifica una descrizione del supporto di origine da usare durante i prompt dei dischi. Questo parametro può essere NULL.

[in] SourceTagfile

Puntatore a una stringa con terminazione null che specifica un file di tag la cui presenza in SourceRootPath indica la presenza dei supporti di origine. Questo parametro può essere NULL. Se non specificato, il file stesso verrà usato come file di tag se necessario.

[in] TargetDirectory

Puntatore a una stringa con terminazione null che specifica la directory in cui deve essere copiato il file.

[in] TargetFilename

Puntatore a una stringa con terminazione null che specifica il nome del file di destinazione. Questo parametro può essere NULL. Se non specificato, il file di destinazione avrà lo stesso nome del file di origine.

[in] CopyStyle

Specifica il comportamento dell'operazione di copia file. Questo parametro può essere una combinazione dei valori seguenti.

SP_COPY_DELETESOURCE

Eliminare il file di origine al termine della copia completata. Il chiamante non riceve una notifica se l'eliminazione ha esito negativo.

SP_COPY_REPLACEONLY

Copiare il file solo se si esegue questa operazione sovrascrivere un file nel percorso di destinazione. Il chiamante non riceve una notifica.

SP_COPY_NEWER_OR SAME

Esaminare ogni file copiato per verificare se le relative risorse di versione indicano che è la stessa versione o meno recente di una copia esistente nella destinazione.

Le informazioni sulla versione del file usate durante i controlli della versione sono specificate nei membri dwFileVersionMS e dwFileVersionLS di una struttura VS_FIXEDFILEINFO, come compilato dalle funzioni di versione. Se uno dei file non dispone di risorse di versione o se hanno informazioni sulla versione identiche, il file di origine viene considerato più recente.

Se il file di origine non è uguale alla versione o alla versione successiva e CopyMsgHandler viene specificato, il chiamante riceve una notifica e può annullare la copia. Se CopyMsgHandler non è specificato, il file non viene copiato.

SP_COPY_NEWER_ONLY

Esaminare ogni file copiato per verificare se le relative risorse di versione indicano che non è più recente di una copia esistente nella destinazione. Se il file di origine è più recente ma non uguale alla versione esistente, il file viene copiato.

SP_COPY_NOOVERWRITE

Verificare se il file di destinazione esiste e, in caso affermativo, avvisare il chiamante che può veto la copia. Se CopyMsgHandler non è specificato, il file non viene sovrascritto.

SP_COPY_NODECOMP

Non decomprimere il file. Quando questo flag è impostato, il file di destinazione non viene dato il formato non compresso del nome di origine (se appropriato). Ad esempio, la copia di f:\x86\cmd.ex_ in \install\temp genera un file di destinazione di \install\temp\cmd.ex_. Se il flag SP_COPY_NODECOMP non è stato specificato, il file verrà decompresso e la destinazione verrà chiamata \install\temp\cmd.exe. La parte del nome file di DestinationName, se specificata, viene rimossa e sostituita con il nome del file di origine. Quando viene specificato SP_COPY_NODECOMP, non è possibile controllare alcuna lingua o informazioni sulla versione.

SP_COPY_LANGUAGEAWARE

Esaminare ogni file copiato per verificare se la lingua è diversa dalla lingua di qualsiasi file esistente già nella destinazione. In tal caso, e CopyMsgHandler viene specificato, il chiamante riceve una notifica e può annullare la copia. Se CopyMsgHandler non è specificato, il file non viene copiato.

SP_COPY_SOURCE_ABSOLUTE

SourceFile è un percorso di origine completo. Non cercarlo nella sezione SourceDisksNames del file INF.

SP_COPY_SOURCEPATH_ABSOLUTE

SourcePathRoot è la parte completa del percorso del file di origine. Ignorare l'origine relativa specificata nella sezione SourceDisksNames del file INF per il supporto di origine in cui si trova il file. Questo flag viene ignorato se viene specificato SP_COPY_SOURCE_ABSOLUTE.

SP_COPY_FORCE_IN_USE

Se la destinazione esiste, comportarsi come se sia in uso e accoda il file per la copia nel riavvio del sistema successivo.

SP_COPY_IN_USE_NEEDS_REBOOT

Se il file è in uso durante l'operazione di copia, avvisare l'utente che il sistema deve essere riavviato.

SP_COPY_NOSKIP

Non concedere all'utente l'opzione di ignorare un file.

SP_COPY_FORCE_NOOVERWRITE

Verificare se il file di destinazione esiste e, in caso affermativo, il file non viene sovrascritto. Il chiamante non riceve una notifica.

SP_COPY_FORCE_NEWER

Esaminare ogni file copiato per verificare se le relative risorse di versione (o i timestamp per i file non immagine) indicano che non è più recente di una copia esistente nella destinazione. Se il file copiato non è più recente, il file non viene copiato. Il chiamante non riceve una notifica.

SP_COPY_WARNIFSKIP

Se l'utente tenta di ignorare un file, avvisare che l'operazione di ignorare un file potrebbe influire sull'installazione. (Usato per i file critici del sistema.

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

Se una directory UNC viene specificata come directory di destinazione di un'operazione di copia file, è necessario assicurarsi che esista prima del commit della coda. Le funzioni di installazione non controllano l'esistenza di e non creano directory UNC. Se la directory UNC di destinazione non esiste, la copia del file avrà esito negativo.

Nota

L'intestazione setupapi.h definisce SetupQueueCopy come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

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