msiquery.h) (MsiViewFetch 函数

  • 项目

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 对象超出范围时会关闭它们，而必须通过调用 MsiCloseHandle 关闭 MSIHANDLE 对象。 有关详细信息，请参阅 Windows Installer 最佳做法中的使用 PMSIHANDLE 而非 HANDLE 部分。

要求

要求 值
最低受支持的客户端 Windows Server 2012、Windows 8、Windows Server 2008 R2 或 Windows 7 上的 Windows Installer 5.0。 Windows Server 2008 或 Windows Vista 上的 Windows Installer 4.0 或 Windows Installer 4.5。 Windows Server 2003 或 Windows XP 上的 Windows Installer
目标平台 Windows
标头 msiquery.h
Library Msi.lib
DLL Msi.dll

另请参阅

常规数据库访问函数

使用查询