通过

MsiViewGetErrorW 函数 （msiquery.h）

  • 项目

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

语法

MSIDBERROR MsiViewGetErrorW(
  [in]      MSIHANDLE hView,
  [out]     LPWSTR    szColumnNameBuffer,
  [in, out] LPDWORD   pcchBuf
);

参数

[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 传入 null 来确定缓冲区的大小，或者 pcchBuf引用的 DWORD 中的缓冲区大小。

返回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
目标平台 窗户
标头 msiquery.h
库 Msi.lib
DLL Msi.dll

另请参阅

常规数据库访问函数

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