IDebugControl4::GetSystemVersionString 方法 (dbgeng.h)
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) |