(dbgeng.h) 的 IDebugControl4::GetSystemVersionString 方法
GetSystemVersionString 方法會傳回描述目標操作系統版本的字串。
語法
HRESULT GetSystemVersionString(
[in] ULONG Which,
[out, optional] PSTR Buffer,
[in] ULONG BufferSize,
[out, optional] PULONG StringSize
);
參數
[in] Which
指定要傳回的版本字串。 下表列出可能的值。
值 | 版本字串 |
---|---|
DEBUG_SYSVERSTR_SERVICE_PACK | 傳回目標操作系統之 Service Pack 的描述。 例如,“Service Pack 1”。 |
DEBUG_SYSVERSTR_BUILD | 傳回目標操作系統組建版本的描述。 例如,“kernel32.dll 版本:5.1.2600.1106 (xpsp1.020828-1920) ”。 |
[out, optional] Buffer
接收版本字串。 如果 Buffer 為 NULL,則不會傳回此資訊。
[in] BufferSize
指定 Buffer 所指定緩衝區的大小,以字元為單位。 此大小包含 『\0』 終止字元的空間。
[out, optional] StringSize
接收識別組建之字串的大小,以字元為單位。 此大小包含 『\0』 終止字元的空間。 如果 SizeString 為 NULL,則不會傳回這項資訊。
傳回值
這個方法也可能傳回錯誤值。 如需詳細資訊,請參閱 傳回值 。
傳回碼 | 描述 |
---|---|
|
此方法成功。 |
|
此方法成功。 不過,緩衝區太小,因此字串遭到截斷。 |
備註
如需詳細資訊,請參閱 目標資訊。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | dbgeng.h (包含 Dbgeng.h) |