IDebugControl::GetSystemVersion 메서드(dbgeng.h)

아티클
08/07/2023

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

플랫폼 ID를 받습니다. PlatformId 는 항상 NT 기반 Windows용으로 VER_PLATFORM_WIN32_NT.

[out] Major

대상의 운영 체제가 무료 빌드인지 또는 운영 체제가 확인된 빌드인지 0xC 0xF 받습니다.

[out] Minor

대상의 운영 체제에 대한 빌드 번호를 받습니다.

[out, optional] ServicePackString

대상 컴퓨터의 서비스 팩 수준에 대한 문자열을 받습니다. ServicePackString이 NULL이면 이 정보가 반환되지 않습니다. 서비스 팩이 설치되어 있지 않으면 ServicePackString이 비어 있을 수 있습니다.

[in] ServicePackStringSize

ServicePackString에서 지정하는 버퍼의 크기를 문자 단위로 지정합니다. 이 크기에는 '\0' 종료 문자의 공간이 포함됩니다.

[out, optional] ServicePackStringUsed

서비스 팩 수준의 문자열 크기를 문자 단위로 받습니다. 이 크기에는 '\0' 종료 문자의 공간이 포함됩니다. ServicePackStringUsed가 NULL이면 이 정보가 반환되지 않습니다.

[out] ServicePackNumber

대상 운영 체제의 서비스 팩 수준을 받습니다.

[out, optional] BuildString

시스템 빌드를 식별하는 문자열을 받습니다. BuildString이 NULL이면 이 정보가 반환되지 않습니다.

[in] BuildStringSize

BuildString에서 지정하는 버퍼의 크기를 문자 단위로 지정합니다. 이 크기에는 '\0' 종료 문자의 공간이 포함됩니다.

[out, optional] BuildStringUsed

빌드를 식별하는 문자열의 크기를 문자 단위로 받습니다. 이 크기에는 '\0' 종료 문자의 공간이 포함됩니다. BuildStringUsed가 NULL이면 이 정보가 반환되지 않습니다.

반환 값

이 메서드는 오류 값을 반환할 수도 있습니다. 자세한 내용은 반환 값을 참조하세요.

반환 코드	Description
S_OK	메서드를 성공적으로 수행했습니다.
S_FALSE	메서드를 성공적으로 수행했습니다. 그러나 ServicePackString 버퍼 또는 BuildString 버퍼가 너무 작아서 해당 문자열이 잘렸습니다.