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 |