SetupDiGetINFClassA 函数 (setupapi.h)

  • 项目

SetupDiGetINFClass 函数返回指定设备 INF 文件的类。

语法

WINSETUPAPI BOOL SetupDiGetINFClassA(
  [in]            PCSTR  InfName,
  [out]           LPGUID ClassGuid,
  [out]           PSTR   ClassName,
  [in]            DWORD  ClassNameSize,
  [out, optional] PDWORD RequiredSize
);

参数

[in] InfName

指向以 NULL 结尾的字符串的指针，该字符串提供设备 INF 文件的名称。 此名称可以包含路径。 但是，如果仅指定了文件名，则会在注册表的 HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion 子项下的 DevicePath 条目中列出的每个目录中搜索该文件。 以 NULL 结尾的 INF 文件名的最大长度（包括 NULL 终止符）是MAX_PATH。

[out] ClassGuid

指向 GUID 类型的变量的指针，该变量接收指定 INF 文件的类 GUID。 如果 INF 文件未指定类名，则函数将返回GUID_NULL结构。 调用 SetupDiClassGuidsFromName 以确定是否已安装一个或多个具有此名称的类。

[out] ClassName

指向缓冲区的指针，该缓冲区接收以 NULL 结尾的字符串，该字符串包含指定 INF 文件的类的名称。 如果 INF 文件未指定类名，但指定 GUID，则此缓冲区将接收通过调用 SetupDiClassNameFromGuid 检索的名称。 但是，如果 SetupDiClassNameFromGuid 无法检索类名 (例如，该类未安装) ，则返回空字符串。

[in] ClassNameSize

ClassName 参数指向的缓冲区的大小（以字符为单位）。 以 NULL 结尾的类名的最大长度（以字符为单位）是MAX_CLASS_NAME_LEN。

[out, optional] RequiredSize

指向 DWORD 类型变量的指针，该变量接收存储类名所需的字符数，包括终止 NULL。 此指针是可选的，可以为 NULL。

返回值

如果成功，该函数将返回 TRUE 。 否则，它将返回 FALSE ，并且可以通过调用 GetLastError 来检索记录的错误。

注解

请勿将此函数用于 Windows 9x 或 Millennium Edition 的 INF 文件。

注意

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

要求

要求 值
最低受支持的客户端 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。
目标平台 桌面
标头 setupapi.h (包括 Setupapi.h)
Library Setupapi.lib

另请参阅

SetupDiBuildClassInfoList

SetupDiClassGuidsFromName

SetupDiClassNameFromGuid

SetupDiGetClassDescription