Funzione VerInstallFileW (winver.h)

Installa il file specificato in base alle informazioni restituite dalla funzione VerFindFile . VerInstallFile decompresse il file, se necessario, assegna un nome file univoco e verifica gli errori, ad esempio i file obsoleti.

Sintassi

DWORD VerInstallFileW(
  [in]      DWORD   uFlags,
  [in]      LPCWSTR szSrcFileName,
  [in]      LPCWSTR szDestFileName,
  [in]      LPCWSTR szSrcDir,
  [in]      LPCWSTR szDestDir,
  [in]      LPCWSTR szCurDir,
  [out]     LPWSTR  szTmpFile,
  [in, out] PUINT   puTmpFileLen
);

Parametri

[in] uFlags

Tipo: DWORD

Questo parametro può avere uno dei valori seguenti. Tutti gli altri bit sono riservati.

[in] szSrcFileName

Tipo: LPCTSTR

Nome del file da installare. Si tratta del nome file nella directory a cui fa riferimento il parametro szSrcDir ; il nome del file può includere solo il nome file e l'estensione, non un percorso.

[in] szDestFileName

Tipo: LPCTSTR

Il nome VerInstallFile darà il nuovo file all'installazione. Questo nome file può essere diverso dal nome del file nella directory szSrcFileName . Il nuovo nome deve includere solo il nome e l'estensione del file, non un percorso.

[in] szSrcDir

Tipo: LPCTSTR

Nome della directory in cui è possibile trovare il file.

[in] szDestDir

Tipo: LPCTSTR

Nome della directory in cui deve essere installato il file. VerFindFile restituisce questo valore nel parametro szDestDir .

[in] szCurDir

Tipo: LPCTSTR

Nome della directory in cui è possibile trovare una versione preesistente di questo file. VerFindFile restituisce questo valore nel parametro szCurDir .

[out] szTmpFile

Tipo: LPTSTR

Nome di una copia temporanea del file di origine. Il buffer deve essere almeno _MAX_PATH caratteri lunghi, anche se questo non è obbligatorio e deve essere vuoto in input.

[in, out] puTmpFileLen

Tipo: PUINT

Lunghezza del buffer szTmpFile . Questo puntatore non deve essere NULL.

Quando la funzione restituisce, lpuTmpFileLen riceve le dimensioni, in caratteri, dei dati restituiti in szTmpFile, incluso il carattere Null di terminazione. Se il buffer è troppo piccolo per contenere tutti i dati, lpuTmpFileLen sarà la dimensione del buffer necessaria per contenere i dati.

Valore restituito

Tipo: DWORD

Il valore restituito è una maschera bit che indica le eccezioni. Può essere uno o più dei valori seguenti. Tutti gli altri valori sono riservati.

Commenti

Questa funzione funziona su immagini di file a 16, 32 e 64 bit.

VerInstallFile copia il file dalla directory di origine alla directory di destinazione. Se szCurDir indica che esiste una versione precedente del file nel sistema, VerInstallFile confronta le informazioni sul timbro della versione dei file. Se la versione installata in precedenza del file è più recente della nuova versione o se gli attributi dei file sono significativamente diversi, ad esempio se si trovano in lingue diverse, VerInstallFile restituisce uno o più codici di errore ripristinabili.

VerInstallFile lascia il file temporaneo nella directory di destinazione. L'applicazione può eseguire l'override dell'errore o eliminare il file temporaneo. Se l'applicazione esegue l'override dell'errore, VerInstallFile elimina la versione installata in precedenza e rinomina il file temporaneo con il nome file originale.

Requisiti

Vedi anche

Informazioni concettuali

Riferimento

VerFindFile

Informazioni sulla versione