次の方法で共有

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

  • [アーティクル]

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

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

[in] ServicePackStringSize

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

[out, optional] ServicePackStringUsed

サービス パック レベルの文字列のサイズ (文字数) を受け取ります。 このサイズには、'\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 バッファーが小さすぎて、対応する文字列が切り捨てられました。

備考

詳細については、「ターゲット情報 を参照してください。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー dbgeng.h (Dbgeng.h、Ntddk.h を含む)

関連項目

GetSystemVersionString の

GetSystemVersionValues の

IDebugControl の

IDebugControl2 の

IDebugControl3 の