msiviewGetErrorA 函数 (msiquery.h)

  • 项目

MsiViewGetError 函数返回 MsiViewModify 函数中发生的错误。

语法

MSIDBERROR MsiViewGetErrorA(
  [in]      MSIHANDLE hView,
  [out]     LPSTR     szColumnNameBuffer,
  [in, out] LPDWORD   pcchBuf
);

parameters

[in] hView

视图的句柄。

[out] szColumnNameBuffer

指向接收以 null 结尾的列名的缓冲区的指针。 请勿尝试通过为 szColumnName 传入 null (value=0) 来确定缓冲区的大小。 可以通过传入空字符串 (（例如“”) ）来获取缓冲区的大小。 然后，该函数返回MSIDBERROR_MOREDATA pcchBuf 在 TCHAR 中包含所需的缓冲区大小，不包括终止 null 字符。 返回MSIDBERROR_NOERROR时， pcchBuf 包含写入缓冲区的 TCHAR 数，不包括终止 null 字符。 如果没有错误，此参数为空字符串。

[in, out] pcchBuf

指向变量的指针，该变量指定 szColumnNameBuffer 指向的缓冲区的大小（以 TCHAR 为单位）。 当函数返回MSIDBERROR_NOERROR时，此变量包含复制到 szColumnNameBuffer 的数据的大小，不包括终止 null 字符。 如果 szColumnNameBuffer 不够大，则该函数将返回MSIDBERROR_MOREDATA并将所需大小（不包括终止 null 字符）存储在 pcchBuf 指向的变量中。

返回值

此函数返回以下值之一。

错误代码 含义
MSIDBERROR_INVALIDARG
 参数无效。
MSIDBERROR_MOREDATA
 缓冲区太小，无法接收数据。
MSIDBERROR_FUNCTIONERROR
 函数失败。
MSIDBERROR_NOERROR
 函数成功完成，没有错误。
MSIDBERROR_DUPLICATEKEY
 新记录复制表中现有记录的主键。
MSIDBERROR_REQUIRED
 不允许有 null 值;或即将删除列，但由另一行引用。
MSIDBERROR_BADLINK
 找不到外表中的相应记录。
MSIDBERROR_OVERFLOW
 数据大于允许的最大值。
MSIDBERROR_UNDERFLOW
 数据小于允许的最小值。
MSIDBERROR_NOTINSET
 数据不是集中允许的值的成员。
MSIDBERROR_BADVERSION
 提供的版本字符串无效。
MSIDBERROR_BADCASE
 案例无效。 大小写必须全部为大写或全部小写。
MSIDBERROR_BADGUID
 提供的 GUID 无效。
MSIDBERROR_BADWILDCARD
 提供的通配符文件名无效，或者通配符的使用无效。
MSIDBERROR_BADIDENTIFIER
 提供的标识符无效。
MSIDBERROR_BADLANGUAGE
 提供的语言 ID 无效。
MSIDBERROR_BADFILENAME
 提供的文件名无效。
MSIDBERROR_BADPATH
 提供的路径无效。
MSIDBERROR_BADCONDITION
 提供了无效的条件语句。
MSIDBERROR_BADFORMATTED
 提供的格式字符串无效。
MSIDBERROR_BADTEMPLATE
 提供的模板字符串无效。
MSIDBERROR_BADDEFAULTDIR
 在 Directory 表的 DefaultDir 列中提供了无效的字符串。
MSIDBERROR_BADREGPATH
 提供的注册表路径字符串无效。
MSIDBERROR_BADCUSTOMSOURCE
 在 CustomAction 表的 CustomSource 列中提供了无效的字符串。
MSIDBERROR_BADPROPERTY
 提供的属性字符串无效。
MSIDBERROR_MISSINGDATA
 _Validation表缺少对列的引用。
MSIDBERROR_BADCATEGORY
 列 的_Validation 表的类别列无效。
MSIDBERROR_BADCABINET
 提供的内阁名称无效。
MSIDBERROR_BADKEYTABLE
 未找到或加载 _Validation 表的 Keytable 列中的表。
MSIDBERROR_BADMAXMINVALUES
 _Validation表的 MaxValue 列中的值小于 MinValue 列中的值。
MSIDBERROR_BADSHORTCUT
 提供的快捷方式目标名称无效。
MSIDBERROR_STRINGOVERFLOW
 字符串对于列定义指定的长度来说太长。
MSIDBERROR_BADLOCALIZEATTRIB
 提供的本地化属性无效。 (主键无法本地化。)
 
 

请注意，在内存不足的情况下，此函数可能会引发STATUS_NO_MEMORY异常。

注解

仅当 MsiViewModify 返回ERROR_INVALID_DATA指示数据无效时，才应调用 MsiViewGetError 函数。 仅记录MSIMODIFY_VALIDATE、MSIMODIFY_VALIDATE_NEW和MSIMODIFY_VALIDATEFIELD的错误。

如果返回ERROR_MORE_DATA，则作为指针的参数会提供保存字符串所需的缓冲区大小。 成功后，它会提供写入字符串缓冲区的字符数。 因此，可以通过传递一个小缓冲区 (最小一个字符) ，并在函数返回MSIDBERROR_MOREDATA时检查 pcchPathBuf 的值来获取所需的缓冲区大小。 请勿尝试通过将 null 作为 szColumnNameBuffer 传入或 pcchBuf 引用的 DWORD 中的缓冲区大小 0 来确定缓冲区的大小。

返回MSIDBERROR_NOERROR后，不再存在验证错误。 MSIDBERROR 返回值指示在 szColumnNameBuffer 标识的列中的值发生的验证错误类型。

注意

msiquery.h 标头将 MsiViewGetError 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

   
最低受支持的客户端 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

请参阅

常规数据库访问函数

将 Null 作为 Windows Installer 函数的参数传递