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

Confira também

Funções de banco de dados

Funções de processamento de registro