Méthode IDebugControl4 ::GetSystemVersionString (dbgeng.h)

Article
02/26/2024

La méthode GetSystemVersionString retourne une chaîne qui décrit la version du système d’exploitation de la cible.

Syntaxe

HRESULT GetSystemVersionString(
  [in]            ULONG  Which,
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG StringSize
);

Paramètres

[in] Which

Spécifie la chaîne de version à retourner. Les valeurs possibles sont répertoriées dans le tableau suivant.

Valeur	Chaîne de version
DEBUG_SYSVERSTR_SERVICE_PACK	Retourne une description du Service Pack pour le système d’exploitation de la cible. Par exemple, « Service Pack 1 ».
DEBUG_SYSVERSTR_BUILD	Retourne une description de la version de build du système d’exploitation cible. Par exemple, « kernel32.dll version : 5.1.2600.1106 (xpsp1.020828-1920) ».

[out, optional] Buffer

Reçoit la chaîne de version. Si Buffer a la valeur NULL, ces informations ne sont pas retournées.

[in] BufferSize

Spécifie la taille, en caractères, de la mémoire tampon spécifiée par Buffer . Cette taille inclut l’espace pour le caractère de fin « \0 ».

[out, optional] StringSize

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 SizeString 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 étant trop petite, la chaîne a été tronquée.

Remarques

Pour plus d’informations, consultez Informations sur la cible.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dbgeng.h (inclure Dbgeng.h)

Voir aussi

GetSystemVersion

GetSystemVersionValues

IDebugControl4

Partager via