Funzione MsiGetFeatureUsageA (msi.h)

La funzione MsiGetFeatureUsage restituisce le metriche di utilizzo per una funzionalità del prodotto.

Sintassi

UINT MsiGetFeatureUsageA(
  [in]  LPCSTR  szProduct,
  [in]  LPCSTR  szFeature,
  [out] LPDWORD pdwUseCount,
  [out] LPWORD  pwDateUsed
);

Parametri

[in] szProduct

Specifica il codice prodotto per il prodotto che contiene la funzionalità.

[in] szFeature

Specifica il codice della funzionalità per la funzionalità per la quale devono essere restituite le metriche.

[out] pdwUseCount

Indica il numero di volte in cui è stata usata la funzionalità.

[out] pwDateUsed

Specifica la data dell'ultimo utilizzo della funzionalità. La data è nel formato di data MS-DOS, come illustrato nella tabella seguente.

BITS Significato
0 – 4
Giorno del mese (1-31)
5 – 8
Mese (1 = gennaio, 2 = febbraio e così via)
9 – 15
Offset dell'anno dal 1980 (aggiunta 1980 per ottenere l'anno effettivo)

Valore restituito

La funzione MsiGetFeatureUsage restituisce i valori seguenti.

Valore Significato
ERROR_BAD_CONFIGURATION
I dati di configurazione sono danneggiati.
ERROR_INSTALL_FAILURE
Nessuna informazione sull'utilizzo disponibile o il prodotto o la funzionalità non è valida.
ERROR_SUCCESS
La funzione è stata completata correttamente.

Commenti

Nota

L'intestazione msi.h definisce MsiGetFeatureUsage 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

   
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

Vedi anche

Funzioni di stato del sistema