IDebugControl3::GetSystemVersion メソッド (dbgeng.h)

[アーティクル]
02/23/2024

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

ターゲットのオペレーティングシステムが無料ビルドの場合は0xF、オペレーティングシステムがチェックビルドの場合は0xCを受け取ります。

[out] Minor

ターゲットのオペレーティングシステムのビルド番号を受け取ります。

[out, optional] ServicePackString

ターゲットコンピューターの Service Pack レベルの文字列を受け取ります。 ServicePackString が NULL の場合、この情報は返されません。 Service Pack がインストールされていない場合は、 ServicePackString を空にすることができます。

[in] ServicePackStringSize

ServicePackString が指定するバッファーのサイズを文字数で指定します。このサイズには、'\0' 終端文字のスペースが含まれます。

[out, optional] ServicePackStringUsed

Service Pack レベルの文字列のサイズを文字単位で受け取ります。このサイズには、'\0' 終端文字のスペースが含まれます。 ServicePackStringUsed が NULL の場合、この情報は返されません。

[out] ServicePackNumber

ターゲットのオペレーティングシステムの Service Pack レベルを受け取ります。

[out, optional] BuildString

システムのビルドを識別する文字列を受け取ります。 BuildString が NULL の場合、この情報は返されません。

[in] BuildStringSize

BuildString が指定するバッファーのサイズを文字数で指定します。このサイズには、'\0' 終端文字のスペースが含まれます。

[out, optional] BuildStringUsed

ビルドを識別する文字列のサイズを文字単位で受け取ります。このサイズには、'\0' 終端文字のスペースが含まれます。 BuildStringUsed が NULL の場合、この情報は返されません。

戻り値

このメソッドは、エラー値を返す場合もあります。詳細については、「戻り値」を参照してください。

リターンコード	説明
S_OK	メソッドは正常に実行されました。
S_FALSE	メソッドは正常に実行されました。ただし、 ServicePackString バッファーまたは BuildString バッファーが小さすぎて、対応する文字列が切り捨てられました。