Funzione MsiEnumFeaturesW (msi.h)
La funzione MsiEnumFeatures enumera le funzionalità pubblicate per un determinato prodotto. Questa funzione recupera un ID funzionalità ogni volta che viene chiamato.
Sintassi
UINT MsiEnumFeaturesW(
[in] LPCWSTR szProduct,
[in] DWORD iFeatureIndex,
[out] LPWSTR lpFeatureBuf,
[out] LPWSTR lpParentBuf
);
Parametri
[in] szProduct
Stringa con terminazione null che specifica il codice prodotto del prodotto le cui funzionalità devono essere enumerate.
[in] iFeatureIndex
Specifica l'indice della funzionalità da recuperare. Questo parametro deve essere zero per la prima chiamata alla funzione MsiEnumFeatures e quindi incrementata per le chiamate successive. Poiché le funzionalità non sono ordinate, qualsiasi nuova funzionalità ha un indice arbitrario. Ciò significa che la funzione può restituire le funzionalità in qualsiasi ordine.
[out] lpFeatureBuf
Puntatore a un buffer che riceve l'ID funzionalità. Le dimensioni del buffer devono contenere un valore stringa di lunghezza MAX_FEATURE_CHARS+1. La funzione restituisce ERROR_MORE_DATA se la lunghezza dell'ID funzionalità supera MAX_FEATURE_CHARS.
[out] lpParentBuf
Puntatore a un buffer che riceve l'ID funzionalità dell'elemento padre della funzionalità. Le dimensioni del buffer devono contenere un valore stringa di lunghezza MAX_FEATURE_CHARS+1. Se la lunghezza dell'ID funzionalità della funzionalità padre supera MAX_FEATURE_CHARS, solo i primi MAX_FEATURE_CHARS caratteri vengono copiati nel buffer.
Valore restituito
| Valore | Significato |
|---|---|
|
I dati di configurazione sono danneggiati. |
|
Un parametro non valido è stato passato alla funzione. |
|
Un buffer è troppo piccolo per contenere i dati richiesti. |
|
Non sono disponibili funzionalità da restituire. |
|
È stato enumerato un valore. |
|
Il prodotto specificato è sconosciuto. |
Commenti
Per enumerare le funzionalità, un'applicazione deve inizialmente chiamare la funzione MsiEnumFeatures con il parametro iFeatureIndex impostato su zero. L'applicazione deve quindi incrementare il parametro iFeatureIndex e chiamare MsiEnumFeatures finché non sono presenti altre funzionalità, ovvero finché la funzione non restituisce ERROR_NO_MORE_ITEMS.
Nota
L'intestazione msi.h definisce MsiEnumFeatures 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 |