Compartilhar via


Função MsiCreateRecord (msiquery.h)

A função MsiCreateRecord cria um novo objeto de registro com o número especificado de campos. Essa função retorna um identificador que deve ser fechado usando MsiCloseHandle.

Sintaxe

MSIHANDLE MsiCreateRecord(
  [in] UINT cParams
);

Parâmetros

[in] cParams

Especifica o número de campos que o registro terá. O número máximo de campos em um registro é limitado a 65535.

Valor retornado

Se a função for bem-sucedida, o valor retornado será manipulado para um novo objeto de registro.

Se a função falhar, o valor retornado será nulo.

Comentários

O campo 0 do objeto de registro criado pela função MsiCreateRecord é usado para formato de cadeias de caracteres e códigos de operação e não está incluído na contagem especificada por cParams. Todos os campos são inicializados como nulos.

Observe que é recomendável usar variáveis do tipo PMSIHANDLE porque o instalador fecha objetos PMSIHANDLE à medida que eles saem do escopo, enquanto você deve fechar objetos MSIHANDLE chamando MsiCloseHandle. Para obter mais informações, confira a seção Use PMSIHANDLE em vez de HANDLE nas Melhores práticas do Windows Installer.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP
Plataforma de Destino Windows
Cabeçalho msiquery.h
Biblioteca Msi.lib
DLL Msi.dll

Confira também

Funções de banco de dados

Funções de processamento de registro