Funzione MsiGetFeatureStateA (msiquery.h)

Articolo
11/20/2024

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, MsiOpenPackageExo MsiOpenProduct.

[in] szFeature

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

[out] piInstalled

Specifica lo stato corrente dell'installazione restituito. Questo parametro non deve essere Null. Questo parametro può essere 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 riconosciuti.
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:

Osservazioni

Vedere Chiamata di funzioni di database da programmi.

Se la funzione non riesce, è 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 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
piattaforma di destinazione	Finestre
intestazione	msiquery.h
libreria	Msi.lib
dll	Msi.dll

Vedere anche

Funzioni di selezione del programma di installazione

passaggio di Null come argomento delle funzioni di Windows Installer

Condividi tramite