Функция MsiDatabaseOpenViewA (msiquery.h)

Функция MsiDatabaseOpenView подготавливает запрос к базе данных и создает объект представления. Эта функция возвращает дескриптор, который должен быть закрыт с помощью MsiCloseHandle.

Синтаксис

UINT MsiDatabaseOpenViewA(
  [in]  MSIHANDLE hDatabase,
  [in]  LPCSTR    szQuery,
  [out] MSIHANDLE *phView
);

Параметры

[in] hDatabase

Дескриптор для базы данных, в которой необходимо открыть объект представления. Дескриптор можно получить, как описано в разделе Получение дескриптора базы данных.

[in] szQuery

Задает строку SQL-запроса для запроса базы данных. Правильный синтаксис см. в разделе Синтаксис SQL.

[out] phView

Указатель на дескриптор возвращаемого представления.

Возвращаемое значение

Функция MsiDatabaseOpenView возвращает одно из следующих значений:

ERROR_SUCCESS в случае успешного выполнения, и задан дескриптор представления, на который указывает параметр phView [out].

ERROR_INVALID_HANDLE, ERROR_INVALID_HANDLE_STATE, ERROR_BAD_QUERY_SYNTAX или ERROR_GEN_FAILURE в случае сбоя и задает запись ошибки, доступную через MsiGetLastErrorRecord.

Комментарии

Функция MsiDatabaseOpenView открывает объект представления для базы данных. Перед выполнением какого-либо выполнения или получения необходимо открыть объект представления для базы данных.

При возникновении ошибки можно вызвать MsiGetLastErrorRecord для получения дополнительных сведений.

Обратите внимание, что рекомендуется использовать переменные типа PMSIHANDLE, так как установщик закрывает объекты PMSIHANDLE по мере их выхода из область, тогда как необходимо закрыть объекты MSIHANDLE, вызвав MsiCloseHandle. Дополнительные сведения см. в разделе Использование PMSIHANDLE вместо HANDLE статьи Рекомендации установщика Windows.

В случае сбоя функции можно получить расширенные сведения об ошибке с помощью MsiGetLastErrorRecord.

Требования

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

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