Функция MsiViewFetch (msiquery.h)
Функция MsiViewFetch извлекает следующую последовательную запись из представления. Эта функция возвращает дескриптор, который должен быть закрыт с помощью MsiCloseHandle.
Синтаксис
UINT MsiViewFetch(
[in] MSIHANDLE hView,
[out] MSIHANDLE *phRecord
);
Параметры
[in] hView
Дескриптор представления для получения.
[out] phRecord
Указатель на дескриптор для извлекаемой записи.
Возвращаемое значение
Обратите внимание, что при нехватке памяти эта функция может вызвать исключение STATUS_NO_MEMORY.
Комментарии
Если функция MsiViewFetch возвращает ERROR_FUNCTION_FAILED, возможно, функция MsiViewExecute не была вызвана первым. Если в результирующем наборе доступно больше строк, MsiViewFetch возвращает phRecord в качестве дескриптора записи, содержащей запрошенные данные столбца, или значение phRecord равно 0. Для максимальной производительности для всех извлечений следует использовать одну и ту же запись, иначе запись должна быть освобождена путем выхода из область.
Обратите внимание, что рекомендуется использовать переменные типа PMSIHANDLE, так как установщик закрывает объекты PMSIHANDLE по мере их выхода из область, тогда как необходимо закрыть объекты MSIHANDLE, вызвав MsiCloseHandle. Дополнительные сведения см. в разделе Использование PMSIHANDLE вместо HANDLE статьи Рекомендации установщика Windows.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Установщик Windows 5.0 в Windows Server 2012, Windows 8, Windows Server 2008 R2 или Windows 7. Установщик Windows 4.0 или установщик Windows 4.5 в Windows Server 2008 или Windows Vista. Установщик Windows в Windows Server 2003 или Windows XP |
| Целевая платформа | Windows |
| Header | msiquery.h |
| Библиотека | Msi.lib |
| DLL | Msi.dll |