Compartilhar via


Função MsiViewExecute (msiquery.h)

A função MsiViewExecute executa uma consulta de exibição SQL e fornece todos os parâmetros necessários. A consulta usa o token de ponto de interrogação para representar parâmetros, conforme descrito em Sintaxe SQL. Os valores desses parâmetros são transmitidos como os campos correspondentes de um registro de parâmetro.

Sintaxe

UINT MsiViewExecute(
  [in] MSIHANDLE hView,
  [in] MSIHANDLE hRecord
);

Parâmetros

[in] hView

Manipule para a exibição na qual executar a consulta.

[in] hRecord

Manipule para um registro que fornece os parâmetros. Esse parâmetro contém valores para substituir os tokens de parâmetro na consulta SQL. É opcional, portanto , hRecord pode ser zero. Para obter uma referência sobre sintaxe, consulte Sintaxe SQL.

Retornar valor

Observe que, em situações de memória insuficiente, essa função pode gerar uma exceção STATUS_NO_MEMORY.

Comentários

A função MsiViewExecute deve ser chamada antes de qualquer chamada para MsiViewFetch.

Se a consulta SQL especificar valores com marcadores de parâmetro (?), um registro deverá ser fornecido que contenha todos os valores de substituição na ordem exata e de tipos de dados compatíveis. Quando usado com consultas INSERT e UPDATE, todos os valores parametrizados devem preceder todos os valores nãoparameterizados.

Por exemplo, essas consultas são válidas.

UPDATE {table-list} SET {column}= ? , {column}= {constant}

INSERT INTO {table} ({column-list}) VALUES (?, {constant-list})

No entanto, essas consultas são inválidas.

UPDATE {table-list} SET {column}= {constant}, {column}=?

INSERT INTO {table} ({column-list}) VALUES ({constant-list}, ? )

Se a função falhar, você poderá obter informações de erro estendidas usando MsiGetLastErrorRecord.

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 gerais de acesso ao banco de dados