Méthode IDebugControl ::GetSystemVersion (dbgeng.h)
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 |
---|---|
|
La méthode a réussi. |
|
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. |
Remarques
Pour plus d’informations, consultez Informations cibles.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Desktop (Expérience utilisateur) |
En-tête | dbgeng.h (inclure Dbgeng.h, Ntddk.h) |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour