Funzione MsiGetFileVersionA (msi.h)

Articolo
11/20/2024

Il MsiGetFileVersion restituisce la stringa di versione e la stringa di lingua nel formato previsto dal programma di installazione nel database. Se si desidera 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 le 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 delle dimensioni complete 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 delle dimensioni complete 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.

Osservazioni

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 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 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 Requisiti di windows Run-Time.
piattaforma di destinazione	Finestre
intestazione	msi.h
libreria	Msi.lib
dll	Msi.dll

Vedere anche

funzioni di stato del sistema

Condividi tramite