Funzione MsiGetFeatureStateA (msiquery.h)

Articolo
08/25/2023

La funzione MsiGetFeatureState ottiene lo stato richiesto di una funzionalità.

Sintassi

UINT MsiGetFeatureStateA(
  [in]  MSIHANDLE    hInstall,
  [in]  LPCSTR       szFeature,
  [out] INSTALLSTATE *piInstalled,
  [out] INSTALLSTATE *piAction
);

Parametri

[in] hInstall

Gestire l'installazione fornita a un'azione personalizzata DLL o ottenuta tramite MsiOpenPackage, MsiOpenPackageEx o MsiOpenProduct.

[in] szFeature

Specifica il nome della funzionalità all'interno del prodotto.

[out] piInstalled

Specifica lo stato corrente installato restituito. Questo parametro non deve essere null. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
INSTALLSTATE_BADCONFIG	I dati di configurazione sono danneggiati.
INSTALLSTATE_INCOMPLETE	L'installazione è sospesa o in corso.
INSTALLSTATE_SOURCEABSENT	La funzionalità deve essere eseguita dall'origine e l'origine non è disponibile.
INSTALLSTATE_MOREDATA	Il buffer restituito è pieno.
INSTALLSTATE_INVALIDARG	Alla funzione è stato passato un parametro non valido.
INSTALLSTATE_UNKNOWN	È stato specificato un prodotto o una funzionalità non riconosciuta.
INSTALLSTATE_BROKEN	La funzionalità è interrotta.
INSTALLSTATE_ADVERTISED	Funzionalità annunciata.
INSTALLSTATE_ABSENT	La funzionalità è stata disinstallata.
INSTALLSTATE_LOCAL	La funzionalità è stata installata nell'unità locale.
INSTALLSTATE_SOURCE	La funzionalità deve essere eseguita dall'origine, dal CD-ROM o dalla rete.
INSTALLSTATE_DEFAULT	La funzionalità viene installata nel percorso predefinito: locale o di origine.

[out] piAction

Riceve l'azione eseguita durante la sessione di installazione. Questo parametro non deve essere null. Per i valori restituiti, vedere piInstalled.

Valore restituito

La funzione MsiGetFeatureState restituisce i valori seguenti:

Commenti

Vedere Chiamata di funzioni di database da programmi.

Se la funzione ha esito negativo, è possibile ottenere informazioni estese sull'errore usando MsiGetLastErrorRecord.

Nota

L'intestazione msiquery.h definisce MsiGetFeatureState 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
Piattaforma di destinazione	Windows
Intestazione	msiquery.h
Libreria	Msi.lib
DLL	Msi.dll

Vedi anche

Funzioni di selezione del programma di installazione

Passaggio di Null come argomento delle funzioni di Windows Installer

Condividi tramite