GetProductInfo 函数 (sysinfoapi.h)

检索本地计算机上的作系统的产品类型,并将类型映射到指定作系统支持的产品类型。

若要在“要求”部分指定的最低受支持的操作系统之前检索有关Windows版本的产品类型信息,请使用 GetVersionEx 函数。 还可以使用 Win32_OperatingSystem WMI 类的 OperatingSystemSKU 属性。

Syntax

BOOL GetProductInfo(
  [in]  DWORD  dwOSMajorVersion,
  [in]  DWORD  dwOSMinorVersion,
  [in]  DWORD  dwSpMajorVersion,
  [in]  DWORD  dwSpMinorVersion,
  [out] PDWORD pdwReturnedProductType
);

Parameters

[in] dwOSMajorVersion

操作系统的主要版本号。 最小值为 6。

dwOSMajorVersion、dwOSMinorVersion、dwSpMajorVersion 和 dwSpMinorVersion 参数的组合描述了应用程序的最大目标操作系统版本。 例如,Windows Vista和 Windows Server 2008 版本为 6.0.0.0 和 Windows 7,Windows Server 2008 R2 版本为 6.1.0.0。 所有基于Windows 10的版本都将列为版本 6.3。

[in] dwOSMinorVersion

操作系统的次版本号。 最低值是0。

[in] dwSpMajorVersion

操作系统 Service Pack 的主要版本号。 最低值是0。

[in] dwSpMinorVersion

操作系统 Service Pack 的次要版本号。 最低值是0。

[out] pdwReturnedProductType

产品类型。 此参数不能 NULL。 如果指定的操作系统小于当前操作系统,则此信息将映射到指定操作系统支持的类型。 如果指定的操作系统大于受支持的最高操作系统,则此信息将映射到当前操作系统支持的类型。

此参数可以是以下值之一(下面的某些产品可能不受支持)。

Value Meaning
PRODUCT_BUSINESS
0x00000006
商业版
PRODUCT_BUSINESS_N
0x00000010
业务 N
PRODUCT_CLUSTER_SERVER
0x00000012
HPC Edition
PRODUCT_CLUSTER_SERVER_V
0x00000040
服务器 Hyper Core V
PRODUCT_CORE
0x00000065
Windows 10主页
PRODUCT_CORE_ARM
0x00000061
Windows RT
PRODUCT_CORE_COUNTRYSPECIFIC
0x00000063
Windows 10家中国
PRODUCT_CORE_N
0x00000062
Windows 10 Home N
PRODUCT_CORE_SINGLELANGUAGE
0x00000064
Windows 10家庭单语言
PRODUCT_DATACENTER_EVALUATION_SERVER
0x00000050
服务器数据中心 (评估安装)
PRODUCT_DATACENTER_A_SERVER_CORE
0x00000091
服务器数据中心,Semi-Annual 频道(核心安装)
PRODUCT_STANDARD_A_SERVER_CORE
0x00000092
服务器标准版、Semi-Annual 通道(核心安装)
PRODUCT_DATACENTER_NANO_SERVER
0x0000008F
Windows Server Datacenter Edition (Nano Server 安装)
PRODUCT_DATACENTER_SERVER
0x00000008
服务器数据中心(完全安装)。对于Windows Server 2012及更高版本的服务器核心安装,请使用该方法,确定服务器核心是否正在运行。
PRODUCT_DATACENTER_SERVER_AZURE_EDITION
0x00000197
Windows Server Datacenter:Azure Edition
PRODUCT_DATACENTER_SERVER_CORE
0x0000000C
服务器数据中心(核心安装,Windows Server 2008 R2 及更早版本)
PRODUCT_DATACENTER_SERVER_CORE_V
0x00000027
无 Hyper-V 的服务器数据中心(核心安装)
PRODUCT_DATACENTER_SERVER_V
0x00000025
无 Hyper-V 的服务器数据中心(完全安装)
PRODUCT_DATACENTER_WS_SERVER_CORE
0x00000093
Windows Server Datacenter Edition (服务器核心安装)
PRODUCT_EDUCATION
0x00000079
Windows 10教育
PRODUCT_EDUCATION_N
0x0000007A
Windows 10教育 N
PRODUCT_EMBEDDED_INDUSTRY
0x00000059
Windows嵌入式行业
PRODUCT_ENTERPRISE
0x00000004
Windows 10 Enterprise
PRODUCT_ENTERPRISE_E
0x00000046
Windows 10 Enterprise E
PRODUCT_ENTERPRISE_EVALUATION
0x00000048
Windows 10企业评估
PRODUCT_ENTERPRISE_N
0x0000001B
Windows 10 Enterprise N
PRODUCT_ENTERPRISE_N_EVALUATION
0x00000054
Windows 10 Enterprise N 评估
PRODUCT_ENTERPRISE_S
0x0000007D
Windows 10 Enterprise 2015 LTSB
PRODUCT_ENTERPRISE_S_EVALUATION
0x00000081
Windows 10 Enterprise 2015 LTSB 评估
PRODUCT_ENTERPRISE_S_N
0x0000007E
Windows 10 Enterprise 2015 LTSB N
PRODUCT_ENTERPRISE_S_N_EVALUATION
0x00000082
Windows 10 Enterprise 2015 LTSB N 评估
PRODUCT_ENTERPRISE_SERVER
0x0000000A
服务器企业版 (完整安装)
PRODUCT_ENTERPRISE_SERVER_CORE
0x0000000E
服务器企业版(核心安装)
PRODUCT_ENTERPRISE_SERVER_CORE_V
0x00000029
无 Hyper-V 的服务器企业版(核心安装)
PRODUCT_ENTERPRISE_SERVER_IA64
0x0000000F
基于 Itanium 的系统的服务器企业
PRODUCT_ENTERPRISE_SERVER_V
0x00000026
无 Hyper-V 的服务器企业版(完整安装)
PRODUCT_ESSENTIALBUSINESS_SERVER_ADDL
0x0000003C
Windows Essential Server 解决方案附加
PRODUCT_ESSENTIALBUSINESS_SERVER_ADDLSVC
0x0000003E
Windows Essential Server 解决方案附加 SVC
PRODUCT_ESSENTIALBUSINESS_SERVER_MGMT
0x0000003B
Windows Essential Server 解决方案管理
PRODUCT_ESSENTIALBUSINESS_SERVER_MGMTSVC
0x0000003D
Windows Essential Server 解决方案管理 SVC
PRODUCT_HOME_BASIC
0x00000002
Home Basic
PRODUCT_HOME_BASIC_E
0x00000043
不支持
PRODUCT_HOME_BASIC_N
0x00000005
Home Basic N
PRODUCT_HOME_PREMIUM
0x00000003
家庭高级版
PRODUCT_HOME_PREMIUM_E
0x00000044
不支持
PRODUCT_HOME_PREMIUM_N
0x0000001A
Home Premium N
PRODUCT_HOME_PREMIUM_SERVER
0x00000022
Windows Home Server 2011
PRODUCT_HOME_SERVER
0x00000013
Windows存储服务器 2008 R2 Essentials
PRODUCT_HYPERV
0x0000002A
Microsoft Hyper-V服务器
PRODUCT_INDUSTRY_HANDHELD
0x00000076
Windows嵌入式手持设备
PRODUCT_IOTENTERPRISE
0x000000BC
Windows IoT Enterprise
PRODUCT_IOTENTERPRISE_S
0x000000BF
Windows IoT Enterprise LTSC
PRODUCT_IOTUAP
0x0000007B
Windows 10 IoT Core
PRODUCT_IOTUAPCOMMERCIAL
0x00000083
Windows 10 IoT Core Commercial
PRODUCT_MEDIUMBUSINESS_SERVER_MANAGEMENT
0x0000001E
Windows Essential Business Server Management Server
PRODUCT_MEDIUMBUSINESS_SERVER_MESSAGING
0x00000020
Windows Essential Business Server Messaging Server
PRODUCT_MEDIUMBUSINESS_SERVER_SECURITY
0x0000001F
Windows Essential Business Server 安全服务器
PRODUCT_MOBILE_CORE
0x00000068
Windows 10移动版
PRODUCT_MOBILE_ENTERPRISE
0x00000085
Windows 10移动企业版
PRODUCT_MULTIPOINT_PREMIUM_SERVER
0x0000004D
Windows MultiPoint Server Premium (完整安装)
PRODUCT_MULTIPOINT_STANDARD_SERVER
0x0000004C
Windows MultiPoint Server Standard (完整安装)
PRODUCT_PPI_PRO
0x00000077
Windows 10团队
PRODUCT_PRO_FOR_EDUCATION
0x000000A4
Windows 10专业教育版
PRODUCT_PRO_WORKSTATION
0x000000A1
Windows 10 Pro for Workstations
PRODUCT_PRO_WORKSTATION_N
0x000000A2
Windows 10 Pro for Workstations N
PRODUCT_PROFESSIONAL
0x00000030
Windows 10 Pro
PRODUCT_PROFESSIONAL_E
0x00000045
不支持
PRODUCT_PROFESSIONAL_N
0x00000031
Windows 10 Pro N
PRODUCT_PROFESSIONAL_WMC
0x00000067
专业媒体中心
PRODUCT_SB_SOLUTION_SERVER
0x00000032
Windows Small Business Server 2011 Essentials
PRODUCT_SB_SOLUTION_SERVER_EM
0x00000036
适用于 SB 解决方案 EM 的服务器
PRODUCT_SERVER_FOR_SB_SOLUTIONS
0x00000033
适用于 SB 解决方案的服务器
PRODUCT_SERVER_FOR_SB_SOLUTIONS_EM
0x00000037
适用于 SB 解决方案 EM 的服务器
PRODUCT_SERVER_FOR_SMALLBUSINESS
0x00000018
Windows Server 2008 for Windows Essential Server Solutions
PRODUCT_SERVER_FOR_SMALLBUSINESS_V
0x00000023
Windows Server 2008,不为 Windows Essential Server 解决方案 Hyper-V
PRODUCT_SERVER_FOUNDATION
0x00000021
Server Foundation
PRODUCT_SERVERRDSH
0x000000AF
适用于虚拟桌面的 Windows 10 Enterprise
PRODUCT_SMALLBUSINESS_SERVER
0x00000009
Windows Small Business Server
PRODUCT_SMALLBUSINESS_SERVER_PREMIUM
0x00000019
Small Business Server Premium
PRODUCT_SMALLBUSINESS_SERVER_PREMIUM_CORE
0x0000003F
Small Business Server Premium (核心安装)
PRODUCT_SOLUTION_EMBEDDEDSERVER
0x00000038
Windows MultiPoint Server
PRODUCT_STANDARD_EVALUATION_SERVER
0x0000004F
服务器标准版(评估安装)
PRODUCT_STANDARD_NANO_SERVER
0x00000090
Windows Server Standard Edition (Nano Server 安装)
PRODUCT_STANDARD_SERVER
0x00000007
服务器标准版(完全安装)。对于Windows Server 2012及更高版本的服务器核心安装,请使用该方法,确定服务器核心是否正在运行。
PRODUCT_STANDARD_SERVER_CORE
0x0000000D
服务器标准版(核心安装,Windows Server 2008 R2 及更早版本)
PRODUCT_STANDARD_SERVER_CORE_V
0x00000028
无 Hyper-V 的服务器标准版(核心安装)
PRODUCT_STANDARD_SERVER_V
0x00000024
无 Hyper-V 的服务器标准
PRODUCT_STANDARD_SERVER_SOLUTIONS
0x00000034
服务器解决方案高级版
PRODUCT_STANDARD_SERVER_SOLUTIONS_CORE
0x00000035
服务器解决方案高级版(核心安装)
PRODUCT_STANDARD_WS_SERVER_CORE
0x00000094
Windows Server Standard Edition (服务器核心安装)
PRODUCT_STARTER
0x0000000B
初学者
PRODUCT_STARTER_E
0x00000042
不支持
PRODUCT_STARTER_N
0x0000002F
初学者 N
PRODUCT_STORAGE_ENTERPRISE_SERVER
0x00000017
存储服务器企业版
PRODUCT_STORAGE_ENTERPRISE_SERVER_CORE
0x0000002E
存储服务器企业版 (核心安装)
PRODUCT_STORAGE_EXPRESS_SERVER
0x00000014
存储服务器 Express
PRODUCT_STORAGE_EXPRESS_SERVER_CORE
0x0000002B
存储服务器 Express (核心安装)
PRODUCT_STORAGE_STANDARD_EVALUATION_SERVER
0x00000060
存储服务器标准版(评估安装)
PRODUCT_STORAGE_STANDARD_SERVER
0x00000015
存储服务器标准
PRODUCT_STORAGE_STANDARD_SERVER_CORE
0x0000002C
存储服务器标准版(核心安装)
PRODUCT_STORAGE_WORKGROUP_EVALUATION_SERVER
0x0000005F
存储服务器工作组 (评估安装)
PRODUCT_STORAGE_WORKGROUP_SERVER
0x00000016
存储服务器工作组
PRODUCT_STORAGE_WORKGROUP_SERVER_CORE
0x0000002D
存储服务器工作组(核心安装)
PRODUCT_THINPC
0x00000057
Windows瘦电脑
PRODUCT_ULTIMATE
0x00000001
Ultimate
PRODUCT_ULTIMATE_E
0x00000047
不支持
PRODUCT_ULTIMATE_N
0x0000001C
Ultimate N
PRODUCT_UNDEFINED
0x00000000
未知产品
PRODUCT_WEB_SERVER
0x00000011
Web 服务器 (完整安装)
PRODUCT_WEB_SERVER_CORE
0x0000001D
Web 服务器(核心安装)

返回值

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

如果该函数失败,则返回值为零。 如果其中一个输入参数无效,则此函数将失败。

注解

若要检测是否安装了服务器角色或功能,请使用 服务器功能 WMI 提供程序。

后续版本的Windows将它支持的产品类型映射到每个受支持的早期版本的Windows支持的产品类型集,回到版本 6.0.0.0。 因此,对上述任何值执行相等性测试的应用程序将继续处理将来的版本,即使添加新的产品类型也是如此。

PRODUCT_*_SERVER_CORE值不会在Windows Server 2012及更高版本中返回。 例如,基本服务器版本服务器数据中心用于生成两个不同的安装选项:“完整服务器”和“核心服务器”。 使用 Windows Server 2012,GetProductInfo 将返回PRODUCT_DATACENTER,而不考虑在产品安装过程中使用的选项。 如上所述,对于 Windows Server 2012 及更高版本的 Server Core 安装,请使用确定服务器核心是否正在运行的方法。

下表指示在 6.1.0.0 中引入的产品类型,以及它们在 6.1.0.0 系统上使用版本 6.0.0.0 调用 GetProductInfo 时将映射到哪些类型。

6.1.0.0 的新增功能 使用 6.0.0.0 返回的值
PRODUCT_PROFESSIONAL PRODUCT_BUSINESS
PRODUCT_PROFESSIONAL_N PRODUCT_BUSINESS_N
PRODUCT_STARTER_N PRODUCT_STARTER
 

若要编译使用此函数的应用程序,请将_WIN32_WINNT定义为0x0600或更高版本。 有关详细信息,请参阅 使用 Windows 标头。

Examples

有关示例,请参阅 “获取系统版本”。

Requirements

Requirement Value
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
Header sysinfoapi.h (包括 Windows.h)
Library 内核 32.lib
DLL Kernel32.dll

另请参阅

系统信息函数