Функция 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.

Требования

См. также раздел

Общие функции доступа к базе данных

Работа с запросами