IsWow64GuestMachineSupported, fonction (wow64apiset.h)

  • Article

Détermine les architectures prises en charge (sous WOW64) sur l’architecture de machine donnée.

Syntaxe

HRESULT IsWow64GuestMachineSupported(
  [in]  USHORT WowGuestMachine,
  [out] BOOL   *MachineIsSupported
);

Paramètres

[in] WowGuestMachine

Valeur IMAGE_FILE_MACHINE_* qui spécifie la machine à tester.

[out] MachineIsSupported

En cas de réussite, retourne un pointeur vers une valeur booléenne : true si la machine prend en charge WOW64, ou false si ce n’est pas le cas.

Valeur retournée

En cas de réussite, retourne S_OK ; sinon, retourne une erreur. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

IsWow64GuestMachineSupported est conçu pour les scénarios suivants :

  • Débogueurs (tels que Visual Studio) qui souhaitent déterminer les extensions de débogueur qu’il doit installer sur le système.
  • Applications qui doivent déterminer si WOW64 est désactivé ou non. Par exemple, de nombreuses applications supposent que les systèmes x86-64 peuvent toujours exécuter du code x86-32 à tout moment, partout. Notez que cette fonctionnalité n’existe pas sur WinPE ou Xbox et qu’il s’agit d’un composant facultatif dans Server.
  • Les suites de tests qui doivent obtenir une couverture complète des fonctionnalités en exécutant des tests sur toutes les architectures prises en charge dans le système.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1709 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2016 (applications de bureau uniquement)
Plateforme cible Windows
En-tête wow64apiset.h
Bibliothèque Kernel32.dll
DLL Kernel32.lib