(dbgeng.h) IDebugControl::GetSystemVersion 方法
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,則不會傳回此資訊。
傳回值
這個方法也可能傳回錯誤值。 如需詳細資訊,請參閱 傳回值 。
傳回碼 | 描述 |
---|---|
|
此方法成功。 |
|
此方法成功。 不過, ServicePackString 緩衝區或 BuildString 緩衝區太小,且對應的字串已截斷。 |
備註
如需詳細資訊,請參閱 目標資訊。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | dbgeng.h (包含 Dbgeng.h、Ntddk.h) |