Expand Minimize

IDebugControl::GetSystemVersion method

The GetSystemVersion method returns information that identifies the operating system on the computer that is running the current target.

Syntax


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
);

Parameters

PlatformId [out]

Receives the platform ID. PlatformId is always VER_PLATFORM_WIN32_NT for NT-based Windows.

Major [out]

Receives 0xF if the target's operating system is a free build, or 0xC if the operating system is a checked build.

Minor [out]

Receives the build number for the target's operating system.

ServicePackString [out, optional]

Receives the string for the service pack level of the target computer. If ServicePackString is NULL, this information is not returned. If no service pack is installed, ServicePackString can be empty.

ServicePackStringSize [in]

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

ServicePackStringUsed [out, optional]

Receives the size, in characters, of the string of the service pack level. If ServicePackStringUsed is NULL, this information is not returned.

ServicePackNumber [out]

Receives the service pack level of the target's operating system.

BuildString [out, optional]

Receives the string that identifies the build of the system. If BuildString is NULL, this information is not returned.

BuildStringSize [in]

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

BuildStringUsed [out, optional]

Receives the size, in characters, of the string that identifies the build. If BuildStringUsed 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 ServicePackString buffer or the BuildString buffer were too small and the corresponding string was truncated.

 

Remarks

For more information, see Target Information.

Requirements

Header

Dbgeng.h (include Dbgeng.h or Ntddk.h)

See also

IDebugControl
IDebugControl2
IDebugControl3
GetSystemVersionString
GetSystemVersionValues

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft