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 |