Condividi tramite

Funzione MsiUseFeatureExA (msi.h)

  • Articolo

La funzione MsiUseFeatureEx incrementa il conteggio di 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 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 utilizzare.

[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 utilizzi futuri. 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 è pubblicata.

Commenti

La funzione MsiUseFeatureEx deve essere usata solo per le 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 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 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