Funzione MsiCollectUserInfoA (msi.h)

La funzione MsiCollectUserInfo ottiene e archivia le informazioni utente e l'ID prodotto da un'installazione guidata.

Sintassi

UINT MsiCollectUserInfoA(
  [in] LPCSTR szProduct
);

Parametri

[in] szProduct

Specifica il codice prodotto del prodotto per il quale vengono raccolte le informazioni sull'utente.

Valore restituito

Valore	Significato
ERROR_INVALID_PARAMETER	Alla funzione è stato passato un parametro non valido.
ERROR_SUCCESS	Funzione completata.
Errore relativo a un'azione	Vedere Codici di errore.
Errore di inizializzazione	Si è verificato un errore relativo all'inizializzazione.

 

 

Commenti

La funzione MsiCollectUserInfo viene in genere chiamata da un'applicazione durante la prima esecuzione dell'applicazione. L'applicazione chiama innanzitutto MsiGetUserInfo. Se la chiamata ha esito negativo, l'applicazione chiama MsiCollectUserInfo. MsiCollectUserInfo apre il pacchetto di installazione del prodotto e richiama una sequenza di procedura guidata che raccoglie le informazioni utente. Al termine della sequenza, le informazioni utente sono registrate. Poiché questa API richiede un'interfaccia utente creata, il livello dell'interfaccia utente deve essere impostato su completo chiamando MsiSetInternalUI come INSTALLUILEVEL_FULL.

MsiCollectUserInfo richiama un dialogo FirstRun.

Nota

L'intestazione msi.h definisce MsiCollectUserInfo 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 solo applicazione

Codici errore

Errore di inizializzazione