Funzione MsiGetFeatureUsageA (msi.h)

Articolo
11/20/2024

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 di funzionalità per la funzionalità per cui 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 MS-DOS data, come illustrato nella tabella seguente.

Bit	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 del 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	Non sono disponibili informazioni sull'utilizzo oppure il prodotto o la funzionalità non è valida.
ERROR_SUCCESS	La funzione è stata completata correttamente.

Osservazioni

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 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 stato del sistema

Condividi tramite