IDebugControl ::GetSystemVersion, méthode (dbgeng.h)

Article
02/06/2025

La méthode GetSystemVersion retourne des informations qui identifient le système d’exploitation sur l’ordinateur exécutant la cible actuelle.

Syntaxe

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

Paramètres

[out] PlatformId

Reçoit l’ID de plateforme. PlatformId est toujours VER_PLATFORM_WIN32_NT pour Windows basé sur NT.

[out] Major

Reçoit 0xF si le système d’exploitation de la cible est une de build gratuiteou 0xC si le système d’exploitation est un build vérifié.

[out] Minor

Reçoit le numéro de build du système d’exploitation de la cible.

[out, optional] ServicePackString

Reçoit la chaîne pour le niveau service pack de l’ordinateur cible. Si ServicePackString est NULL, ces informations ne sont pas retournées. Si aucun Service Pack n’est installé, ServicePackString peut être vide.

[in] ServicePackStringSize

Spécifie la taille, en caractères, de la mémoire tampon qui ServicePackString spécifie. Cette taille inclut l’espace du caractère de fin « \0 ».

[out, optional] ServicePackStringUsed

Reçoit la taille, en caractères, de la chaîne du niveau service pack. Cette taille inclut l’espace du caractère de fin « \0 ». Si ServicePackStringUsed est NULL, ces informations ne sont pas retournées.

[out] ServicePackNumber

Reçoit le niveau service pack du système d’exploitation de la cible.

[out, optional] BuildString

Reçoit la chaîne qui identifie la build du système. Si BuildString est NULL, ces informations ne sont pas retournées.

[in] BuildStringSize

Spécifie la taille, en caractères, de la mémoire tampon qui BuildString spécifie. Cette taille inclut l’espace du caractère de fin « \0 ».

[out, optional] BuildStringUsed

Reçoit la taille, en caractères, de la chaîne qui identifie la build. Cette taille inclut l’espace du caractère de fin « \0 ». Si BuildStringUsed est NULL, ces informations ne sont pas retournées.

Valeur de retour

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez valeurs de retour.

Retourner le code	Description
S_OK	La méthode a réussi.
S_FALSE	La méthode a réussi. Toutefois, la mémoire tampon ServicePackString ou la mémoire tampon BuildString étaient trop petites et la chaîne correspondante a été tronquée.