Funzione MsiUseFeatureExA (msi.h)

Articolo
11/20/2024

La funzione MsiUseFeatureEx incrementa il numero di utilizzo per una determinata funzionalità e indica lo stato di installazione per tale funzionalità. Questa funzione deve essere usata per indicare la finalità di un'applicazione di usare una funzionalità.

Sintassi

INSTALLSTATE MsiUseFeatureExA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szFeature,
  [in] DWORD  dwInstallMode,
  [in] DWORD  dwReserved
);

Parametri

[in] szProduct

Specifica il codice prodotto per il prodotto proprietario della funzionalità da usare.

[in] szFeature

Identifica la funzionalità da usare.

[in] dwInstallMode

Questo parametro può avere il valore seguente.

Valore	Significato
INSTALLMODE_NODETECTION	Il valore restituito indica lo stato di installazione.

[in] dwReserved

Riservato per uso futuro. Questo valore deve essere impostato su 0.

Valore restituito

Valore	Significato
INSTALLSTATE_ABSENT	La funzionalità non è installata.
INSTALLSTATE_ADVERTISED	La funzionalità è pubblicizzata
INSTALLSTATE_LOCAL	La funzionalità è installata in locale e disponibile per l'uso.
INSTALLSTATE_SOURCE	La funzionalità viene installata dall'origine e disponibile per l'uso.
INSTALLSTATE_UNKNOWN	La funzionalità non viene pubblicata.

Osservazioni

La funzione msiUseFeatureEx deve essere usata solo nelle funzionalità note per la pubblicazione. INSTALLSTATE_UNKNOWN indica che il programma sta tentando di usare una funzionalità non pubblicata. L'applicazione deve determinare se la funzionalità viene pubblicata prima di chiamare MsiUseFeature chiamando MsiQueryFeatureState o MsiEnumFeatures. L'applicazione deve effettuare queste chiamate durante l'inizializzazione. Un'applicazione deve usare solo le funzionalità note per la pubblicazione.

Nota

L'intestazione msi.h definisce MsiUseFeatureEx 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 Application-Only

Condividi tramite