struttura SP_FILE_COPY_PARAMS_W (setupapi.h)

Articolo
11/20/2024

La struttura SP_FILE_COPY_PARAMS descrive una singola operazione di copia di file.

Sintassi

typedef struct _SP_FILE_COPY_PARAMS_W {
  DWORD    cbSize;
  HSPFILEQ QueueHandle;
  PCWSTR   SourceRootPath;
  PCWSTR   SourcePath;
  PCWSTR   SourceFilename;
  PCWSTR   SourceDescription;
  PCWSTR   SourceTagfile;
  PCWSTR   TargetDirectory;
  PCWSTR   TargetFilename;
  DWORD    CopyStyle;
  HINF     LayoutInf;
  PCWSTR   SecurityDescriptor;
} SP_FILE_COPY_PARAMS_W, *PSP_FILE_COPY_PARAMS_W;

Membri

cbSize

Dimensioni della struttura, in byte. Impostare sul valore : sizeof(SP_FILE_COPY_PARAMS).

QueueHandle

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

SourceRootPath

Puntatore facoltativo alla radice dell'origine per questa copia, ad esempio A:.

SourcePath

Puntatore facoltativo al percorso relativo a SourceRootPath in cui è possibile trovare il file.

SourceFilename

Parte del nome file da copiare.

SourceDescription

Puntatore facoltativo a una descrizione del supporto di origine da usare durante le richieste del disco.

SourceTagfile

Puntatore facoltativo a un file di tag la cui presenza in SourceRootPath indica la presenza del supporto di origine. Se non specificato, il file stesso verrà usato come file di tag, se necessario.

TargetDirectory

Directory in cui copiare il file.

TargetFilename

Puntatore facoltativo al nome del file di destinazione. Se non specificato, il file di destinazione avrà lo stesso nome del file di origine.

CopyStyle

Flag che controllano il comportamento dell'operazione di copia file. Questi flag possono essere una combinazione dei valori seguenti.

Valore	Significato
SP_COPY_DELETESOURCE	Eliminare il file di origine al termine della copia. Il chiamante non riceve una notifica se l'eliminazione non riesce.
SP_COPY_REPLACEONLY	Copiare il file solo in caso di sovrascrittura di 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 non è più recente di una copia esistente nella destinazione. Le informazioni sulla versione del file usate durante i controlli della versione sono specificate nella dwFileVersionMS e dwFileVersionLS membri di una struttura VS_FIXEDFILEINFO, come compilato dalle funzioni della versione. Se uno dei file non dispone di risorse di versione o se dispone di 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 viene specificato il CopyMsgHandler, il chiamante riceve una notifica e può annullare la copia. Se CopyMsgHandler non viene 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 della destinazione esistente, il file viene copiato.
SP_COPY_NOOVERWRITE	Controllare se il file di destinazione esiste e, in tal caso, inviare una notifica al chiamante che può inviare il veto alla copia. Se CopyMsgHandler non viene specificato, il file non viene sovrascritto.
SP_COPY_NODECOMP	Non decomprimere il file. Quando questo flag è impostato, al file di destinazione non viene assegnato il formato non compresso del nome di origine (se appropriato). Ad esempio, la copia di f:\x86\cmd.ex_ in \\install\temp restituisce 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 specificato, viene rimossa e sostituita con il nome file del file di origine. Quando si specifica 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à presente nella destinazione. In tal caso, e viene specificato il CopyMsgHandler, il chiamante riceve una notifica e può annullare la copia. Se CopyMsgHandler non viene 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, si comporta come se fosse in uso e accoda il file per la copia al successivo riavvio del sistema.
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 la possibilità di ignorare un file.
SP_COPY_FORCE_NOOVERWRITE	Controllare se il file di destinazione esiste e, in tal caso, 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 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, avvisarli che ignorare un file potrebbe influire sull'installazione. Usato per i file critici del sistema.

LayoutInf

Handle in INF da usare per ottenere informazioni di origine.

SecurityDescriptor

Stringa del descrittore di sicurezza facoltativa che specifica l'ACL da applicare al file.

Osservazioni

Nota

L'intestazione setupapi.h definisce SP_FILE_COPY_PARAMS 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]
intestazione	setupapi.h

Vedere anche

panoramica

strutture

Condividi tramite