Funzione MsiGetFeatureInfoA (msi.h)

Articolo
11/20/2024

La funzione msiGetFeatureInfo restituisce informazioni descrittive per una funzionalità.

Sintassi

UINT MsiGetFeatureInfoA(
  [in]                MSIHANDLE hProduct,
  [in]                LPCSTR    szFeature,
  [out, optional]     LPDWORD   lpAttributes,
  [out, optional]     LPSTR     lpTitleBuf,
  [in, out, optional] LPDWORD   pcchTitleBuf,
  [out, optional]     LPSTR     lpHelpBuf,
  [in, out, optional] LPDWORD   pcchHelpBuf
);

Parametri

[in] hProduct

Gestire il prodotto proprietario della funzionalità. Questo handle viene ottenuto da MsiOpenProduct.

[in] szFeature

Codice di funzionalità per la funzionalità su quali informazioni devono essere restituite.

[out, optional] lpAttributes

Puntatore a una posizione contenente uno o più dei flag di attributo seguenti.

INSTALLFEATUREATTRIBUTE_FAVORLOCAL (1)

INSTALLFEATUREATTRIBUTE_FAVORSOURCE (2)

INSTALLFEATUREATTRIBUTE_FOLLOWPARENT (4)

INSTALLFEATUREATTRIBUTE_FAVORADVERTISE (8)

INSTALLFEATUREATTRIBUTE_DISALLOWADVERTISE (16)

INSTALLFEATUREATTRIBUTE_NOUNSUPPORTEDADVERTISE (32)

Per altre informazioni, vedere
tabella delle funzionalità. I valori restituiti MsiGetFeatureInfo corrispondono al doppio dei valori nella colonna Attributi della tabella delle funzionalità.

[out, optional] lpTitleBuf

Puntatore a un buffer per ricevere il nome localizzato della funzionalità, che corrisponde al campo Titolo nel Tabella delle funzionalità.

Questo parametro è facoltativo e può essere Null.

[in, out, optional] pcchTitleBuf

Come input, le dimensioni di lpTitleBuf. Come output, il numero di caratteri restituiti in lpTitleBuf. In input, si tratta delle dimensioni complete del buffer e include uno spazio per un carattere Null di terminazione. Se il buffer passato è troppo piccolo, il conteggio restituito non include il carattere Null di terminazione.

[out, optional] lpHelpBuf

Puntatore a un buffer per ricevere la descrizione localizzata della funzionalità, che corrisponde al campo Descrizione per la funzionalità nella tabella delle funzionalità . Questo parametro è facoltativo e può essere Null.

[in, out, optional] pcchHelpBuf

Come input, le dimensioni di lpHelpBuf. Come output, il numero di caratteri restituiti in lpHelpBuf. In input, si tratta delle dimensioni complete del buffer e include uno spazio per un carattere Null di terminazione. Se il buffer passato è troppo piccolo, il conteggio restituito non include il carattere Null di terminazione.

Valore restituito

Codice restituito	Descrizione
ERROR_INVALID_HANDLE	L'handle del prodotto non è valido.
ERROR_INVALID_PARAMETER	Uno dei parametri non è valido.
ERROR_MORE_DATA	Un buffer è troppo piccolo per contenere i dati richiesti.
ERROR_SUCCESS	La funzione restituisce correttamente.
ERROR_UNKNOWN_FEATURE	La funzionalità non è nota.

Osservazioni

Le dimensioni del buffer per la funzione MsiGetFeatureInfo devono includere un carattere aggiuntivo per il carattere Null di terminazione. Se un buffer è troppo piccolo, la stringa restituita viene troncata con null e la dimensione del buffer contiene il numero di caratteri nell'intera stringa, senza includere il carattere Null di terminazione. Per altre informazioni, vedere Chiamata di funzioni di database da programmi.

Nota

L'intestazione msi.h definisce MsiGetFeatureInfo 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 query del prodotto

Condividi tramite