Funzione MsiGetFileVersionA (msi.h)

Articolo
08/24/2023

MsiGetFileVersion restituisce la stringa di versione e la stringa di lingua nel formato previsto dal programma di installazione per trovarli nel database. Se si desiderano solo informazioni sulla versione, impostare lpLangBuf e pcchLangBuf su 0 (zero). Se vuoi solo informazioni sulla lingua, imposta lpVersionBuf e pcchVersionBuf su 0 (zero).

Sintassi

UINT MsiGetFileVersionA(
  [in]      LPCSTR  szFilePath,
  [out]     LPSTR   lpVersionBuf,
  [in, out] LPDWORD pcchVersionBuf,
  [out]     LPSTR   lpLangBuf,
  [in, out] LPDWORD pcchLangBuf
);

Parametri

[in] szFilePath

Specifica il percorso del file.

[out] lpVersionBuf

Restituisce la versione del file.

Impostare su 0 solo per informazioni sulla lingua.

[in, out] pcchVersionBuf

Numero di buffer in e out come numero di TCHAR.

Impostare su 0 (zero) solo per le informazioni sulla lingua. Nell'input si tratta della dimensione completa del buffer, incluso uno spazio per un carattere Null di terminazione. Se il buffer passato è troppo piccolo, il conteggio restituito non include il carattere Null di terminazione.

[out] lpLangBuf

Restituisce la lingua dei file.

Impostare su 0 (zero) solo per le informazioni sulla versione.

[in, out] pcchLangBuf

Numero di buffer in e out come numero di TCHAR.

Impostare su 0 (zero) solo per le informazioni sulla versione. Nell'input si tratta della dimensione completa del buffer, incluso uno spazio per un carattere Null di terminazione. Se il buffer passato è troppo piccolo, il conteggio restituito non include il carattere Null di terminazione.

Valore restituito

Valore	Significato
ERROR_SUCCESS	Completamento.
ERROR_FILE_NOT_FOUND	Il file non esiste.
ERROR_ACCESS_DENIED	Impossibile aprire il file per ottenere informazioni sulla versione.
ERROR_FILE_INVALID	Il file non contiene informazioni sulla versione.
ERROR_INVALID_DATA	Le informazioni sulla versione non sono valide.
E_FAIL	Errore imprevisto.

Commenti

Nota

L'intestazione msi.h definisce MsiGetFileVersion 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti


Client minimo supportato	Windows Installer 5.0 in Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 in Windows Server 2008 o Windows Vista. Windows Installer in Windows Server 2003 o Windows XP. Per informazioni sul Service Pack minimo di Windows richiesto da una versione di Windows Installer, vedere Windows Installer Run-Time Requirements .See the Windows Installer requirements for information about the minimum Windows Service Pack that is required by a Windows Installer version.
Piattaforma di destinazione	Windows
Intestazione	msi.h
Libreria	Msi.lib
DLL	Msi.dll

Vedi anche

Funzioni di stato del sistema

Condividi tramite