Compartilhar via


Função MsiViewFetch (msiquery.h)

A função MsiViewFetch busca o próximo registro sequencial da exibição. Essa função retorna um identificador que deve ser fechado usando MsiCloseHandle.

Sintaxe

UINT MsiViewFetch(
  [in]  MSIHANDLE hView,
  [out] MSIHANDLE *phRecord
);

Parâmetros

[in] hView

Manipule para o modo de exibição do qual buscar.

[out] phRecord

Ponteiro para o identificador do registro buscado.

Retornar valor

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

Comentários

Se a função MsiViewFetch retornar ERROR_FUNCTION_FAILED, é possível que a função MsiViewExecute não tenha sido chamada primeiro. Se mais linhas estiverem disponíveis no conjunto de resultados, MsiViewFetchretornará phRecord como um identificador para um registro que contém os dados de coluna solicitados ou phRecord será 0. Para obter o desempenho máximo, o mesmo registro deve ser usado para todas as recuperações ou o registro deve ser liberado saindo do escopo.

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

Como trabalhar com consultas