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

Vedi anche

Funzioni di database

Funzioni di elaborazione dei record