Méthode IDebugControl3 ::GetSystemVersion (dbgeng.h)

Article
02/23/2024

La méthode GetSystemVersion retourne des informations qui identifient le système d’exploitation sur l’ordinateur qui exécute 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 NT.

[out] Major

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

[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 a la valeur 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 spécifiée par ServicePackString . Cette taille inclut l’espace pour le 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 pour le caractère de fin « \0 ». Si ServicePackStringUsed a la valeur 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 a lavaleur NULL, ces informations ne sont pas retournées.

[in] BuildStringSize

Spécifie la taille, en caractères, de la mémoire tampon spécifiée par BuildString . Cette taille inclut l’espace pour le 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 pour le caractère de fin « \0 ». Si BuildStringUsed a la valeur NULL, ces informations ne sont pas retournées.

Valeur retournée

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

Code de retour	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.