Funzione MsiUseFeatureA (msi.h)
La funzione MsiUseFeature incrementa il conteggio dell'utilizzo per una particolare 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 MsiUseFeatureA(
[in] LPCSTR szProduct,
[in] LPCSTR szFeature
);
Parametri
[in] szProduct
Specifica il codice prodotto per il prodotto proprietario della funzionalità da usare.
[in] szFeature
Identifica la funzionalità da usare.
Valore restituito
| Valore | Significato |
|---|---|
|
La funzionalità non è installata. |
|
La funzionalità è pubblicizzata |
|
I dati di configurazione sono danneggiati. |
|
Argomento funzione non valido. |
|
La funzionalità è installata in locale e disponibile per l'uso. |
|
La funzionalità viene installata dall'origine e disponibile per l'uso. |
|
La funzionalità non viene pubblicata. |
Commenti
La funzione MsiUseFeature deve essere usata solo sulle 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 MsiUseFeature 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 |