Metode IDebugControl3::GetSystemVersion (dbgeng.h)

Artikel
02/23/2024

Metode GetSystemVersion mengembalikan informasi yang mengidentifikasi sistem operasi pada komputer yang menjalankan target saat ini.

Sintaks

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

Parameter

[out] PlatformId

Menerima ID platform. PlatformId selalu VER_PLATFORM_WIN32_NT untuk Windows berbasis NT.

[out] Major

Menerima 0xF jika sistem operasi target adalah build gratis, atau 0xC jika sistem operasi adalah build yang diperiksa.

[out] Minor

Menerima nomor build untuk sistem operasi target.

[out, optional] ServicePackString

Menerima string untuk tingkat paket layanan komputer target. Jika ServicePackStringADALAH NULL, informasi ini tidak dikembalikan. Jika tidak ada paket layanan yang diinstal, ServicePackString bisa kosong.

[in] ServicePackStringSize

Menentukan ukuran, dalam karakter, dari buffer yang ditentukan ServicePackString . Ukuran ini mencakup ruang untuk karakter '\0' yang mengakhiri.

[out, optional] ServicePackStringUsed

Menerima ukuran, dalam karakter, dari string tingkat paket layanan. Ukuran ini mencakup ruang untuk karakter '\0' yang mengakhiri. Jika ServicePackStringUsed adalah NULL, informasi ini tidak dikembalikan.

[out] ServicePackNumber

Menerima tingkat paket layanan dari sistem operasi target.

[out, optional] BuildString

Menerima string yang mengidentifikasi build sistem. Jika BuildStringNULL, informasi ini tidak dikembalikan.

[in] BuildStringSize

Menentukan ukuran, dalam karakter, dari buffer yang ditentukan BuildString . Ukuran ini mencakup ruang untuk karakter '\0' yang mengakhiri.

[out, optional] BuildStringUsed

Menerima ukuran, dalam karakter, dari string yang mengidentifikasi build. Ukuran ini mencakup ruang untuk karakter '\0' yang mengakhiri. Jika BuildStringUsedadalah NULL, informasi ini tidak dikembalikan.

Nilai kembali

Metode ini juga dapat mengembalikan nilai kesalahan. Lihat Mengembalikan Nilai untuk detail selengkapnya.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
S_FALSE	Metode berhasil. Namun, buffer ServicePackString atau buffer BuildString terlalu kecil dan string yang sesuai dipotok.