GetProductInfo 函式 (sysinfoapi.h)

擷取本地電腦作業系統的產品類型,並將該類型映射到指定作業系統支援的產品類型。

若要取得需求區中指定最低支援作業系統版本之前的 Windows 版本產品類型資訊,請使用 GetVersionEx 函式。 你也可以使用 Win32_OperatingSystem WMI 類別的 OperatingSystemSKU 屬性。

句法

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

作業系統服務包的主要版本號。 最低值為0。

[in] dwSpMinorVersion

作業系統服務包的次要版本號。 最低值為0。

[out] pdwReturnedProductType

產品類型。 這個參數不能 NULL。 若指定的作業系統小於目前作業系統,這些資訊會映射到指定作業系統所支援的類型。 若指定的作業系統大於最高支援的作業系統,則此資訊會映射到目前作業系統所支援的類型。

此參數可為以下數值之一(以下部分產品可能不支援)。

Value Meaning
PRODUCT_BUSINESS
0x00000006
Business
PRODUCT_BUSINESS_N
0x00000010
商業N
PRODUCT_CLUSTER_SERVER
0x00000012
HPC 版
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 及更新版本的 Server Core,請使用「判斷 Server Core 是否正在執行」的方法。)
PRODUCT_DATACENTER_SERVER_AZURE_EDITION
0x00000197
Windows Server Datacenter: Azure Edition
PRODUCT_DATACENTER_SERVER_CORE
0x0000000C
Server Datacenter(核心安裝,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(Server Core 安裝)
PRODUCT_EDUCATION
0x00000079
Windows 10 教育
PRODUCT_EDUCATION_N
0x0000007A
Windows 10 教育版 N
PRODUCT_EMBEDDED_INDUSTRY
0x00000059
Windows 嵌入式產業
PRODUCT_ENTERPRISE
0x00000004
Windows 10 企業版
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
Server Enterprise(完整安裝)
PRODUCT_ENTERPRISE_SERVER_CORE
0x0000000E
Server Enterprise(核心安裝)
PRODUCT_ENTERPRISE_SERVER_CORE_V
0x00000029
沒有 Hyper-V 的 Server Enterprise(核心安裝)
PRODUCT_ENTERPRISE_SERVER_IA64
0x0000000F
基於 Itanium 系統的 Server Enterprise
PRODUCT_ENTERPRISE_SERVER_V
0x00000026
Server Enterprise 無 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
家庭基礎
PRODUCT_HOME_BASIC_E
0x00000043
不支援
PRODUCT_HOME_BASIC_N
0x00000005
家庭 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 Storage Server 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 商業伺服器管理伺服器
PRODUCT_MEDIUMBUSINESS_SERVER_MESSAGING
0x00000020
Windows Essential 商業伺服器訊息伺服器
PRODUCT_MEDIUMBUSINESS_SERVER_SECURITY
0x0000001F
Windows Essential 商業伺服器安全伺服器
PRODUCT_MOBILE_CORE
0x00000068
Windows 10 Mobile
PRODUCT_MOBILE_ENTERPRISE
0x00000085
Windows 10 行動企業版
PRODUCT_MULTIPOINT_PREMIUM_SERVER
0x0000004D
Windows MultiPoint Server Premium(完整安裝)
PRODUCT_MULTIPOINT_STANDARD_SERVER
0x0000004C
Windows 多點伺服器標準(完整安裝)
PRODUCT_PPI_PRO
0x00000077
Windows 10 團隊
PRODUCT_PRO_FOR_EDUCATION
0x000000A4
Windows 10 專業版教育
PRODUCT_PRO_WORKSTATION
0x000000A1
Windows 10 Pro 工作站版
PRODUCT_PRO_WORKSTATION_N
0x000000A2
Windows 10 Pro 工作站 N
PRODUCT_PROFESSIONAL
0x00000030
Windows 10 專業版
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 精選
PRODUCT_SB_SOLUTION_SERVER_EM
0x00000036
SB Solutions EM 伺服器
PRODUCT_SERVER_FOR_SB_SOLUTIONS
0x00000033
SB 解決方案伺服器
PRODUCT_SERVER_FOR_SB_SOLUTIONS_EM
0x00000037
SB Solutions EM 伺服器
PRODUCT_SERVER_FOR_SMALLBUSINESS
0x00000018
Windows Server 2008 for Windows Essential Server 解決方案
PRODUCT_SERVER_FOR_SMALLBUSINESS_V
0x00000023
Windows Server 2008 年無 Hyper-V Windows Essential Server Solutions
PRODUCT_SERVER_FOUNDATION
0x00000021
伺服器基金會
PRODUCT_SERVERRDSH
0x000000AF
Windows 10 Enterprise 虛擬桌面版
PRODUCT_SMALLBUSINESS_SERVER
0x00000009
Windows Small Business Server
PRODUCT_SMALLBUSINESS_SERVER_PREMIUM
0x00000019
小型企業伺服器高級服務
PRODUCT_SMALLBUSINESS_SERVER_PREMIUM_CORE
0x0000003F
小型企業伺服器高級版(核心安裝)
PRODUCT_SOLUTION_EMBEDDEDSERVER
0x00000038
Windows 多點伺服器
PRODUCT_STANDARD_EVALUATION_SERVER
0x0000004F
伺服器標準(評估安裝)
PRODUCT_STANDARD_NANO_SERVER
0x00000090
Windows Server 標準版(Nano Server 安裝)
PRODUCT_STANDARD_SERVER
0x00000007
伺服器標準(完整安裝。對於安裝 Windows Server 2012 及更新版本的 Server Core,請使用「判斷 Server Core 是否正在執行」的方法。)
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
Server Solutions Premium(核心安裝)
PRODUCT_STANDARD_WS_SERVER_CORE
0x00000094
Windows Server 標準版(Server Core 安裝)
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
儲存伺服器快運
PRODUCT_STORAGE_EXPRESS_SERVER_CORE
0x0000002B
Storage Server 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
終極賽
PRODUCT_ULTIMATE_E
0x00000047
不支援
PRODUCT_ULTIMATE_N
0x0000001C
終極N
PRODUCT_UNDEFINED
0x00000000
未知產品
PRODUCT_WEB_SERVER
0x00000011
網頁伺服器(完整安裝)
PRODUCT_WEB_SERVER_CORE
0x0000001D
網頁伺服器(核心安裝)

返回值

如果函式成功,傳回值會是非零值。

如果函數失敗,則傳回值為零。 若其中一個輸入參數無效,此函式即告失敗。

備註

要偵測是否安裝了伺服器角色或功能,請使用 伺服器功能 WMI 提供者。

後續版本的 Windows 會將其支援的產品類型映射到每個先前支援的 Windows 版本所支援的產品類型集合,回到版本 6.0.0.0。 因此,對任一這些數值進行等性測試的應用程式,即使新增產品類型,未來版本仍能持續運作。

PRODUCT_*_SERVER_CORE 值在 Windows Server 2012 及之後不會回傳。 例如,基礎伺服器版本 Server Datacenter 用於建置兩種不同的安裝選項:「完整伺服器」與「核心伺服器」。 有了Windows Server 2012,GetProductInfo 無論安裝時使用哪種選項,都會回傳PRODUCT_DATACENTER。 如前所述,對於安裝 Windows Server 2012 及更新版本的 Server Core,請使用「判斷 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

也請參閱

系統資訊功能