Funzione VerFindFileW (winver.h)

Determina dove installare un file in base all'individuazione di un'altra versione del file nel sistema. I valori VerFindFile restituiti nei buffer specificati vengono usati in una chiamata successiva alla funzione VerInstallFile.

Sintassi

DWORD VerFindFileW(
  [in]           DWORD   uFlags,
  [in]           LPCWSTR szFileName,
  [in, optional] LPCWSTR szWinDir,
  [in]           LPCWSTR szAppDir,
  [out]          LPWSTR  szCurDir,
  [in, out]      PUINT   puCurDirLen,
  [out]          LPWSTR  szDestDir,
  [in, out]      PUINT   puDestDirLen
);

Parametri

[in] uFlags

Tipo: DWORD

Questo parametro può essere il valore seguente. Tutti gli altri bit sono riservati.

[in] szFileName

Tipo: LPCTSTR

Nome del file da installare. Includere solo il nome e l'estensione del file, non un percorso.

[in, optional] szWinDir

Tipo: LPCTSTR

Directory in cui Windows è in esecuzione o verrà eseguita. Questa stringa viene restituita dalla funzione GetWindowsDirectory.

[in] szAppDir

Tipo: LPCTSTR

Directory in cui il programma di installazione installa un set di file correlati. Se il programma di installazione installa un'applicazione, si tratta della directory in cui risiederà l'applicazione. Questo parametro punta anche alla directory corrente dell'applicazione, se non diversamente specificato.

[out] szCurDir

Tipo: LPWSTR

Buffer che riceve il percorso di una versione corrente del file in fase di installazione. Il percorso è una stringa con terminazione zero. Se non è installata una versione corrente, il buffer conterrà una stringa di lunghezza zero. Il buffer deve contenere almeno _MAX_PATH caratteri, anche se questo non è obbligatorio.

[in, out] puCurDirLen

Tipo: PUINT

Lunghezza del buffer di szCurDir. Questo puntatore non deve essere NULL.

Quando la funzione viene restituita, lpuCurDirLen contiene le dimensioni, in caratteri, dei dati restituiti in szCurDir, incluso il carattere Null di terminazione. Se il buffer è troppo piccolo per contenere tutti i dati, lpuCurDirLen sarà la dimensione del buffer necessaria per contenere il percorso.

[out] szDestDir

Tipo: LPTSTR

Buffer che riceve il percorso di installazione consigliato da VerFindFile. Il percorso è una stringa con terminazione zero. Il buffer deve contenere almeno _MAX_PATH caratteri, anche se questo non è obbligatorio.

[in, out] puDestDirLen

Tipo: PUINT

Puntatore a una variabile che specifica la lunghezza del buffer szDestDir. Questo puntatore non deve essere NULL.

Quando la funzione viene restituita, lpuDestDirLen contiene le dimensioni, in caratteri, dei dati restituiti in szDestDir, incluso il carattere Null di terminazione. Se il buffer è troppo piccolo per contenere tutti i dati, lpuDestDirLen sarà la dimensione del buffer necessaria per contenere il percorso.

Valore restituito

Tipo: DWORD

Il valore restituito è una maschera di bit che indica lo stato del file. Può essere uno o più dei valori seguenti. Tutti gli altri valori sono riservati.

Osservazioni

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

VerFindFile cerca una copia del file specificato usando la funzione OpenFile. Tuttavia, determina la directory di sistema dalla directory di Windows specificata o cerca il percorso.

Se il parametro dwFlags indica che il file è privato per questa applicazione (non VFFF_ISSHAREDFILE), VerFindFile consiglia di installare il file nella directory dell'applicazione. In caso contrario, se il sistema esegue una copia condivisa del sistema, la funzione consiglia di installare il file nella directory di Windows. Se il sistema esegue una copia privata del sistema, la funzione consiglia di installare il file nella directory di sistema.

Fabbisogno

Vedere anche

concettuale

GetWindowsDirectory

OpenFile

altre risorse

riferimento

VerInstallFile

informazioni sulla versione