(dbgeng.h) IDebugControl：：GetSystemVersion 方法

發行項
02/25/2024

GetSystemVersion 方法會傳回資訊，識別執行目前目標之計算機上的操作系統。

語法

HRESULT GetSystemVersion(
  [out]           PULONG PlatformId,
  [out]           PULONG Major,
  [out]           PULONG Minor,
  [out, optional] PSTR   ServicePackString,
  [in]            ULONG  ServicePackStringSize,
  [out, optional] PULONG ServicePackStringUsed,
  [out]           PULONG ServicePackNumber,
  [out, optional] PSTR   BuildString,
  [in]            ULONG  BuildStringSize,
  [out, optional] PULONG BuildStringUsed
);

參數

[out] PlatformId

接收平台標識碼。 PlatformId 一律會針對 NT 型 Windows VER_PLATFORM_WIN32_NT。

[out] Major

如果目標的操作系統是免費組建，則會收到0xF，如果操作系統是已核取的組建，則0xC。

[out] Minor

接收目標操作系統的組建編號。

[out, optional] ServicePackString

接收目標電腦的 Service Pack 層級字串。如果 ServicePackString 為 NULL，則不會傳回這項資訊。如果未安裝 Service Pack，ServicePackString 可以是空的。

[in] ServicePackStringSize

指定 ServicePackString 所指定緩衝區的大小，以字元為單位。此大小包含『\0』終止字元的空間。

[out, optional] ServicePackStringUsed

接收 Service Pack 層級字串的大小，以字元為單位。此大小包含『\0』終止字元的空間。如果 ServicePackStringUsed 為 NULL，則不會傳回這項資訊。

[out] ServicePackNumber

接收目標操作系統的 Service Pack 層級。

[out, optional] BuildString

接收識別系統組建的字串。如果 BuildString 為 NULL，則不會傳回此資訊。

[in] BuildStringSize

指定 BuildString 所指定緩衝區的大小，以字元為單位。此大小包含『\0』終止字元的空間。

[out, optional] BuildStringUsed

接收識別組建之字串的大小，以字元為單位。此大小包含『\0』終止字元的空間。如果 BuildStringUsed 為 NULL，則不會傳回此資訊。

傳回值

這個方法也可能傳回錯誤值。如需詳細資訊，請參閱傳回值。

傳回碼	描述
S_OK	此方法成功。
S_FALSE	此方法成功。不過， ServicePackString 緩衝區或 BuildString 緩衝區太小，且對應的字串已截斷。