共用方式為


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
);

參數

[in] dwOSMajorVersion

作業系統的主要版本號碼。 最小值為 6。

dwOSMajorVersiondwOSMinorVersiondwSpMajorVersiondwSpMinorVersion參數的組合描述應用程式的目標作業系統版本上限。 例如,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。 如果指定的作業系統小於目前的作業系統,這項資訊會對應至指定作業系統所支援的類型。 如果指定的作業系統大於最高支援的作業系統,這項資訊會對應至目前作業系統所支援的類型。

此參數可以是下列其中一個值, (以下某些產品可能不支援) 。

意義
PRODUCT_BUSINESS
0x00000006
Microsoft Store
PRODUCT_BUSINESS_N
0x00000010
商務 N
PRODUCT_CLUSTER_SERVER
0x00000012
HPC Edition
PRODUCT_CLUSTER_SERVER_V
0x00000040
伺服器 Hyper Core V
PRODUCT_CORE
0x00000065
Windows 10 Home
PRODUCT_CORE_COUNTRYSPECIFIC
0x00000063
Windows 10 家用版中國
PRODUCT_CORE_N
0x00000062
Windows 10 家用版 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_SERVER
0x00000008
伺服器資料中心 (完整安裝。針對 Windows Server 2012 和更新版本的 Server Core 安裝,請使用 方法來 判斷 Server Core 是否正在執行。)
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_EDUCATION
0x00000079
Windows 10 教育版
PRODUCT_EDUCATION_N
0x0000007A
Windows 10 Education N
PRODUCT_ENTERPRISE
0x00000004
Windows 10 Enterprise
PRODUCT_ENTERPRISE_E
0x00000046
Windows 10 企業版 E
PRODUCT_ENTERPRISE_EVALUATION
0x00000048
Windows 10 企業版評估
PRODUCT_ENTERPRISE_N
0x0000001B
Windows 10 Enterprise N
PRODUCT_ENTERPRISE_N_EVALUATION
0x00000054
Windows 10 企業版 N 評估
PRODUCT_ENTERPRISE_S
0x0000007D
Windows 10 Enterprise 2015 LTSB
PRODUCT_ENTERPRISE_S_EVALUATION
0x00000081
Windows 10 企業評估版 2015 長期維護
PRODUCT_ENTERPRISE_S_N
0x0000007E
Windows 10 Enterprise 2015 LTSB N
PRODUCT_ENTERPRISE_S_N_EVALUATION
0x00000082
Windows 10 企業版 2015 長期維護 N 評估
PRODUCT_ENTERPRISE_SERVER
0x0000000A
Server Enterprise (完整安裝)
PRODUCT_ENTERPRISE_SERVER_CORE
0x0000000E
Server Enterprise (核心安裝)
PRODUCT_ENTERPRISE_SERVER_CORE_V
0x00000029
無 Hyper-V 的伺服器企業版 (核心安裝)
PRODUCT_ENTERPRISE_SERVER_IA64
0x0000000F
Server Enterprise for Itanium-based Systems
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
家用入門版
PRODUCT_HOME_BASIC_E
0x00000043
不支援
PRODUCT_HOME_BASIC_N
0x00000005
首頁基本 N
PRODUCT_HOME_PREMIUM
0x00000003
家用進階版
PRODUCT_HOME_PREMIUM_E
0x00000044
不支援
PRODUCT_HOME_PREMIUM_N
0x0000001A
家用進階 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 Server
PRODUCT_IOTENTERPRISE
0x000000BC
Windows IoT 企業版
PRODUCT_IOTENTERPRISE_S
0x000000BF
Windows IoT 企業版 LTSC
PRODUCT_IOTUAP
0x0000007B
Windows 10 IoT 核心版
PRODUCT_IOTUAPCOMMERCIAL
0x00000083
Windows 10 IoT 核心版 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 Security Server
PRODUCT_MOBILE_CORE
0x00000068
Windows 10 Mobile
PRODUCT_MOBILE_ENTERPRISE
0x00000085
Windows 10 Mobile Enterprise
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 工作站專業版
PRODUCT_PRO_WORKSTATION_N
0x000000A2
Windows 10 工作站專業版 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 Essential Server 解決方案的 Windows Server 2008
PRODUCT_SERVER_FOR_SMALLBUSINESS_V
0x00000023
沒有適用于 Windows Essential Server 解決方案的 Hyper-V 的 Windows Server 2008
PRODUCT_SERVER_FOUNDATION
0x00000021
Server Foundation
PRODUCT_SERVERRDSH
0x000000AF
虛擬桌面Windows 10 企業版
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_SERVER
0x00000007
伺服器標準 (完整安裝。針對 Windows Server 2012 和更新版本的 Server Core 安裝,請使用 方法來 判斷 Server Core 是否正在執行。)
PRODUCT_STANDARD_SERVER_CORE
0x0000000D
Server Standard (核心安裝、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_STARTER
0x0000000B
入門
PRODUCT_STARTER_E
0x00000042
不支援
PRODUCT_STARTER_N
0x0000002F
入門 N
PRODUCT_STORAGE_ENTERPRISE_SERVER
0x00000017
儲存體伺服器企業版
PRODUCT_STORAGE_ENTERPRISE_SERVER_CORE
0x0000002E
Storage Server Enterprise (核心安裝)
PRODUCT_STORAGE_EXPRESS_SERVER
0x00000014
儲存體伺服器 Express
PRODUCT_STORAGE_EXPRESS_SERVER_CORE
0x0000002B
儲存體伺服器 Express (核心安裝)
PRODUCT_STORAGE_STANDARD_EVALUATION_SERVER
0x00000060
儲存體伺服器 Standard (評估安裝)
PRODUCT_STORAGE_STANDARD_SERVER
0x00000015
儲存體伺服器標準
PRODUCT_STORAGE_STANDARD_SERVER_CORE
0x0000002C
儲存體伺服器 Standard (核心安裝)
PRODUCT_STORAGE_WORKGROUP_EVALUATION_SERVER
0x0000005F
儲存體伺服器工作組 (評估安裝)
PRODUCT_STORAGE_WORKGROUP_SERVER
0x00000016
儲存體伺服器工作組
PRODUCT_STORAGE_WORKGROUP_SERVER_CORE
0x0000002D
儲存體伺服器工作組 (核心安裝)
PRODUCT_ULTIMATE
0x00000001
旗艦版
PRODUCT_ULTIMATE_E
0x00000047
不支援
PRODUCT_ULTIMATE_N
0x0000001C
Ultimate N
PRODUCT_UNDEFINED
0x00000000
未知的產品
PRODUCT_WEB_SERVER
0x00000011
網頁伺服器 (完整安裝)
PRODUCT_WEB_SERVER_CORE
0x0000001D
Web Server (核心安裝)

傳回值

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

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

備註

若要偵測是否已安裝伺服器角色或功能,請使用 伺服器功能 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 標頭

範例

如需範例,請參閱 取得系統版本

需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 sysinfoapi.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

系統資訊函式