检索本地计算机上的作系统的产品类型,并将类型映射到指定作系统支持的产品类型。
若要在“要求”部分指定的最低受支持的操作系统之前检索有关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 |
|---|---|
|
商业版 |
|
业务 N |
|
HPC Edition |
|
服务器 Hyper Core V |
|
Windows 10主页 |
|
Windows RT |
|
Windows 10家中国 |
|
Windows 10 Home N |
|
Windows 10家庭单语言 |
|
服务器数据中心 (评估安装) |
|
服务器数据中心,Semi-Annual 频道(核心安装) |
|
服务器标准版、Semi-Annual 通道(核心安装) |
|
Windows Server Datacenter Edition (Nano Server 安装) |
|
服务器数据中心(完全安装)。对于Windows Server 2012及更高版本的服务器核心安装,请使用该方法,确定服务器核心是否正在运行。 |
|
Windows Server Datacenter:Azure Edition |
|
服务器数据中心(核心安装,Windows Server 2008 R2 及更早版本) |
|
无 Hyper-V 的服务器数据中心(核心安装) |
|
无 Hyper-V 的服务器数据中心(完全安装) |
|
Windows Server Datacenter Edition (服务器核心安装) |
|
Windows 10教育 |
|
Windows 10教育 N |
|
Windows嵌入式行业 |
|
Windows 10 Enterprise |
|
Windows 10 Enterprise E |
|
Windows 10企业评估 |
|
Windows 10 Enterprise N |
|
Windows 10 Enterprise N 评估 |
|
Windows 10 Enterprise 2015 LTSB |
|
Windows 10 Enterprise 2015 LTSB 评估 |
|
Windows 10 Enterprise 2015 LTSB N |
|
Windows 10 Enterprise 2015 LTSB N 评估 |
|
服务器企业版 (完整安装) |
|
服务器企业版(核心安装) |
|
无 Hyper-V 的服务器企业版(核心安装) |
|
基于 Itanium 的系统的服务器企业 |
|
无 Hyper-V 的服务器企业版(完整安装) |
|
Windows Essential Server 解决方案附加 |
|
Windows Essential Server 解决方案附加 SVC |
|
Windows Essential Server 解决方案管理 |
|
Windows Essential Server 解决方案管理 SVC |
|
Home Basic |
|
不支持 |
|
Home Basic N |
|
家庭高级版 |
|
不支持 |
|
Home Premium N |
|
Windows Home Server 2011 |
|
Windows存储服务器 2008 R2 Essentials |
|
Microsoft Hyper-V服务器 |
|
Windows嵌入式手持设备 |
|
Windows IoT Enterprise |
|
Windows IoT Enterprise LTSC |
|
Windows 10 IoT Core |
|
Windows 10 IoT Core Commercial |
|
Windows Essential Business Server Management Server |
|
Windows Essential Business Server Messaging Server |
|
Windows Essential Business Server 安全服务器 |
|
Windows 10移动版 |
|
Windows 10移动企业版 |
|
Windows MultiPoint Server Premium (完整安装) |
|
Windows MultiPoint Server Standard (完整安装) |
|
Windows 10团队 |
|
Windows 10专业教育版 |
|
Windows 10 Pro for Workstations |
|
Windows 10 Pro for Workstations N |
|
Windows 10 Pro |
|
不支持 |
|
Windows 10 Pro N |
|
专业媒体中心 |
|
Windows Small Business Server 2011 Essentials |
|
适用于 SB 解决方案 EM 的服务器 |
|
适用于 SB 解决方案的服务器 |
|
适用于 SB 解决方案 EM 的服务器 |
|
Windows Server 2008 for Windows Essential Server Solutions |
|
Windows Server 2008,不为 Windows Essential Server 解决方案 Hyper-V |
|
Server Foundation |
|
适用于虚拟桌面的 Windows 10 Enterprise |
|
Windows Small Business Server |
|
Small Business Server Premium |
|
Small Business Server Premium (核心安装) |
|
Windows MultiPoint Server |
|
服务器标准版(评估安装) |
|
Windows Server Standard Edition (Nano Server 安装) |
|
服务器标准版(完全安装)。对于Windows Server 2012及更高版本的服务器核心安装,请使用该方法,确定服务器核心是否正在运行。 |
|
服务器标准版(核心安装,Windows Server 2008 R2 及更早版本) |
|
无 Hyper-V 的服务器标准版(核心安装) |
|
无 Hyper-V 的服务器标准 |
|
服务器解决方案高级版 |
|
服务器解决方案高级版(核心安装) |
|
Windows Server Standard Edition (服务器核心安装) |
|
初学者 |
|
不支持 |
|
初学者 N |
|
存储服务器企业版 |
|
存储服务器企业版 (核心安装) |
|
存储服务器 Express |
|
存储服务器 Express (核心安装) |
|
存储服务器标准版(评估安装) |
|
存储服务器标准 |
|
存储服务器标准版(核心安装) |
|
存储服务器工作组 (评估安装) |
|
存储服务器工作组 |
|
存储服务器工作组(核心安装) |
|
Windows瘦电脑 |
|
Ultimate |
|
不支持 |
|
Ultimate N |
|
未知产品 |
|
Web 服务器 (完整安装) |
|
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 |