Função MsiDatabaseGetPrimaryKeysA (msiquery.h)

Artigo
11/20/2024

A função MsiDatabaseGetPrimaryKeys retorna um registro que contém os nomes de todas as colunas de chave primária para uma tabela especificada. Essa função retorna um identificador que deve ser fechado usando MsiCloseHandle.

Sintaxe

UINT MsiDatabaseGetPrimaryKeysA(
  [in]  MSIHANDLE hDatabase,
  [in]  LPCSTR    szTableName,
  [out] MSIHANDLE *phRecord
);

Parâmetros

[in] hDatabase

Manipule para o banco de dados. Consulte Obtendo um identificador de banco de dados.

[in] szTableName

Especifica o nome da tabela da qual obter nomes de chave primária.

[out] phRecord

Ponteiro para o identificador do registro que contém os nomes de chave primária.

Valor de retorno

Essa função retorna UINT.

Observações

A contagem de campos do registro retornado é a contagem de colunas de chave primária retornadas pela função MsiDatabaseGetPrimaryKeys. O registro retornado contém o nome da tabela em Campo (0) e os nomes de coluna que compõem os nomes de chave primária nos campos de êxito. Esses nomes de chave primária correspondem aos números de coluna dos campos.

Essa função não pode ser usada com a tabela _Tables ou a tabela _Columns.

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, consulte Usar PMSIHANDLE em vez da seção HANDLE node Práticas Recomendadas do Instalador do Windows .

Nota

O cabeçalho msiquery.h define MsiDatabaseGetPrimaryKeys como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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

Consulte também

Funções gerais de acesso ao banco de dados

Compartilhar via