IDebugControl4::GetSystemVersionString method

The GetSystemVersionString method returns a string that describes the target's operating system version.

Syntax


HRESULT GetSystemVersionString(
  [in]             ULONG Which,
  [out, optional]  PSTR Buffer,
  [in]             ULONG BufferSize,
  [out, optional]  PULONG StringSize
);

Parameters

Which [in]

Specifies which version string to return. The possible values are listed in the following table.

ValueVersion string

DEBUG_SYSVERSTR_SERVICE_PACK

Returns a description of the service pack for the target's operating system. For example, "Service Pack 1".

DEBUG_SYSVERSTR_BUILD

Returns a description of the target's operating system build version. For example, "kernel32.dll version: 5.1.2600.1106 (xpsp1.020828-1920)".

 

Buffer [out, optional]

Receives the version string. If Buffer is NULL, this information is not returned.

BufferSize [in]

Specifies the size, in characters, of the buffer that Buffer specifies.

StringSize [out, optional]

Receives the size, in characters, of the string that identifies the build. If SizeString is NULL, this information is not returned.

Return value

This method may also return error values. See Return Values for more details.

Return codeDescription
S_OK

The method was successful.

S_FALSE

The method was successful. However, the buffer was too small, so the string was truncated.

 

Remarks

For more information, see Target Information.

Requirements

Header

Dbgeng.h (include Dbgeng.h)

See also

IDebugControl4
GetSystemVersion
GetSystemVersionValues

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft