Funzione MsiCreateRecord (msiquery.h)
La funzione MsiCreateRecord crea un nuovo oggetto record con il numero specificato di campi. Questa funzione restituisce un handle che deve essere chiuso usando MsiCloseHandle.
Sintassi
MSIHANDLE MsiCreateRecord(
[in] UINT cParams
);
Parametri
[in] cParams
Specifica il numero di campi che il record avrà. Il numero massimo di campi in un record è limitato a 65535.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene gestito in un nuovo oggetto record.
Se la funzione ha esito negativo, il valore restituito è Null.
Commenti
Il campo 0 dell'oggetto record creato dalla funzione MsiCreateRecord viene usato per formattare stringhe e codici di operazione e non è incluso nel conteggio specificato da cParams. Tutti i campi vengono inizializzati su Null.
Si noti che è consigliabile usare variabili di tipo PMSIHANDLE perché il programma di installazione chiude gli oggetti PMSIHANDLE mentre escono dall'ambito, mentre è necessario chiudere gli oggetti MSIHANDLE chiamando MsiCloseHandle. Per altre informazioni, vedere Usare PMSIHANDLE anziché la sezione HANDLE nelle procedure consigliate di Windows Installer.
Requisiti
| 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 |
| Piattaforma di destinazione | Windows |
| Intestazione | msiquery.h |
| Libreria | Msi.lib |
| DLL | Msi.dll |