Función MsiCreateRecord (msiquery.h)

La función MsiCreateRecord crea un nuevo objeto de registro con el número especificado de campos. Esta función devuelve un identificador que se debe cerrar mediante MsiCloseHandle.

Sintaxis

MSIHANDLE MsiCreateRecord(
  [in] UINT cParams
);

Parámetros

[in] cParams

Especifica el número de campos que tendrá el registro. El número máximo de campos de un registro está limitado a 65 535.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto se controla en un nuevo objeto de registro.

Si se produce un error en la función, el valor devuelto es NULL.

Comentarios

El campo 0 del objeto de registro creado por la función MsiCreateRecord se usa para cadenas de formato y códigos de operación y no se incluye en el recuento especificado por cParams. Todos los campos se inicializan en null.

Tenga en cuenta que se recomienda usar variables de tipo PMSIHANDLE porque el instalador cierra los objetos PMSIHANDLE a medida que salen del ámbito, mientras que debe cerrar objetos MSIHANDLE mediante una llamada a MsiCloseHandle. Para más información, consulte la sección Uso de PMSIHANDLE, en lugar de HANDLE en los procedimientos recomendados de Windows Installer.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Installer 5.0 en Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 en Windows Server 2008 o Windows Vista. Windows Installer en Windows Server 2003 o Windows XP
Plataforma de destino	Windows
Encabezado	msiquery.h
Library	Msi.lib
Archivo DLL	Msi.dll

Consulte también

Funciones de base de datos

Funciones de procesamiento de registros