Funzione MsiGetProductInfoFromScriptA (msi.h)

Articolo
03/13/2024

La funzione MsiGetProductInfoFromScript restituisce informazioni sul prodotto per un file di script di Windows Installer.

Sintassi

UINT MsiGetProductInfoFromScriptA(
  [in]      LPCSTR  szScriptFile,
  [out]     LPSTR   lpProductBuf39,
  [out]     LANGID  *plgidLanguage,
  [out]     LPDWORD pdwVersion,
  [out]     LPSTR   lpNameBuf,
  [in, out] LPDWORD pcchNameBuf,
  [out]     LPSTR   lpPackageBuf,
  [in, out] LPDWORD pcchPackageBuf
);

Parametri

[in] szScriptFile

Stringa con terminazione null che specifica il percorso completo del file di script. Il file di script è lo script di annuncio creato chiamando MsiAdvertiseProduct o MsiAdvertiseProductEx.

[out] lpProductBuf39

Punta a un buffer che riceve il codice prodotto. Il buffer deve essere lungo 39 caratteri. I primi 38 caratteri sono per il GUID del codice prodotto e l'ultimo carattere è per il carattere Null terminante.

[out] plgidLanguage

Punta a una variabile che riceve la lingua del prodotto.

[out] pdwVersion

Punta a un buffer che riceve la versione del prodotto.

[out] lpNameBuf

Punta a un buffer che riceve il nome del prodotto. Il buffer include un carattere null terminante.

[in, out] pcchNameBuf

Punta a una variabile che specifica le dimensioni, in caratteri, del buffer a cui punta il parametro lpNameBuf . Questa dimensione deve includere il carattere Null terminante. Quando la funzione restituisce, questa variabile contiene la lunghezza della stringa archiviata nel buffer. Il conteggio restituito non include il carattere Null terminante. Se il buffer non è abbastanza grande, la funzione restituisce ERROR_MORE_DATA e la variabile contiene le dimensioni della stringa in caratteri, senza contare il carattere Null.

[out] lpPackageBuf

Punta a un buffer che riceve il nome del pacchetto. Il buffer include il carattere Null terminante.

[in, out] pcchPackageBuf

Punta a una variabile che specifica le dimensioni, in caratteri, del buffer a cui punta il parametro lpPackageNameBuf . Questa dimensione deve includere il carattere Null terminante. Quando la funzione restituisce, questa variabile contiene la lunghezza della stringa archiviata nel buffer. Il conteggio restituito non include il carattere Null terminante. Se il buffer non è abbastanza grande, la funzione restituisce ERROR_MORE_DATA e la variabile contiene le dimensioni della stringa in caratteri, senza contare il carattere Null.

Valore restituito

Valore	Significato
ERROR_SUCCESS	La funzione è stata completata correttamente.
ERROR_INVALID_PARAMETER	Un argomento non valido è stato passato alla funzione.
ERROR_MORE_DATA	Un buffer era troppo piccolo per contenere l'intero valore.
ERROR_INSTALL_FAILURE	Impossibile ottenere informazioni sullo script.
ERROR_CALL_NOT_IMPLEMENTED	Questa funzione è disponibile solo in Windows 2000 e Windows XP.

Commenti

Nota

L'intestazione msi.h definisce MsiGetProductInfoFromScript come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

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 i requisiti di Windows Installer Run-Time.
Piattaforma di destinazione	Windows
Intestazione	msi.h
Libreria	Msi.lib
DLL	Msi.dll

Condividi tramite