通过

SetupQueryInfVersionInformationA 函数 （setupapi.h）

  • 项目

[此函数可用于“要求”部分所示的操作系统。 在后续版本中可能会更改或不可用。 不应再使用 SetupAPI 来安装应用程序。 请改用 Windows Installer 来开发应用程序安装程序。 SetupAPI 继续用于安装设备驱动程序。]

SetupQueryInfVersionInformation 函数将 INF 文件版本信息从 SP_INF_INFORMATION 结构返回到缓冲区。

语法

WINSETUPAPI BOOL SetupQueryInfVersionInformationA(
  [in]      PSP_INF_INFORMATION InfInformation,
  [in]      UINT                InfIndex,
  [in]      PCSTR               Key,
  [in, out] PSTR                ReturnBuffer,
  [in]      DWORD               ReturnBufferSize,
  [in, out] PDWORD              RequiredSize
);

参数

[in] InfInformation

指向以前从调用 SetupGetInfInformation 函数返回的 SP_INF_INFORMATION 结构的指针。

[in] InfIndex

要从中检索版本信息的构成 INF 文件的索引。 此索引可以位于 [0， InfInformation.InfCount） 范围内。 这意味着值零到（但不包括）InfInformation.InfCount 有效。

[in] Key

指向 null-terminated 字符串的可选指针，其中包含要检索其关联字符串的键名称。 如果此参数 NULL，则将所有资源密钥复制到提供的缓冲区。 每个字符串 null-terminated，列表末尾有额外的 null。

[in, out] ReturnBuffer

如果未 NULL，ReturnBuffer 指向调用提供的字符缓冲区，在此缓冲区中，此函数返回 INF 文件样式。 应使用 null-terminated 字符串。 null-terminated 字符串不应超过目标缓冲区的大小。 可以调用函数一次以获取所需的缓冲区大小、分配必要的内存，然后再次调用该函数以检索数据。 使用此技术，可以避免由于缓冲区大小不足而导致的错误。 请参阅“备注”部分。 此参数可以 NULL。

[in] ReturnBufferSize

ReturnBuffer 参数指向的缓冲区的大小（以字符为单位）。 此数字包括 null 终止符。

[in, out] RequiredSize

如果未 NULL，则指针指向接收 ReturnBuffer 参数指向的缓冲区所需的大小的变量（以字符为单位）。 此数字包括 null 终止符。 如果指定 ReturnBuffer 并且实际大小大于 returnBufferSize指定的值，则函数 将失败，并且调用 getLastError 返回ERROR_INSUFFICIENT_BUFFER。

返回值

如果函数成功，则返回值为非零值。

如果函数失败，则返回值为零。 若要获取扩展的错误信息，请调用 GetLastError。

言论

如果使用 NULL 的 ReturnBuffer 和零的 ReturnBufferSize 调用此函数，则该函数会将指定数据保留到 RequiredSize所指向的变量中所需的缓冲区大小。 如果函数成功，则返回值为非零值。 否则，返回值为零，可通过调用 getLastError获取扩展错误信息。

如果对旧 INF 文件调用 SetupQueryInfVersionInformation，则以以下方式从旧 INF 文件生成版本信息：

  1. 旧文件的 标识 部分中的 OptionType 键作为类键值返回。
  2. 旧版 INF 文件的 Signature 部分中的 FileType 密钥将成为签名密钥值。
  3. 如果旧版 INF 文件的 FileType 键的值MICROSOFT_FILE，则提供程序密钥值设置为“Microsoft”。
下表总结了在信息传递到 SP_INF_INFORMATION 结构之前如何转换信息。
旧文件信息 Windows INF 信息 
[Identification]
OptionType = Mouse

[Version]
Class=Mouse

[Signature]
FileType = MICROSOFT_FILE

Signature=MICROSOFT_FILE
（如果 FileType 为 MICROSOFT_FILE） 
Provider="Microsoft"
 

注意

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

要求

要求 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 setupapi.h
库 Setupapi.lib
DLL Setupapi.dll

另请参阅

Functions

概述

SetupGetInfInformation

SetupQueryInfFileInformation