IsWow64GuestMachineSupported function

[Some information relates to pre-released product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.]

Determines which architectures are supported (under WOW64) on the given machine architecture.

Syntax

HRESULT IsWow64GuestMachineSupported(
  USHORT WowGuestMachine,
  BOOL   *MachineIsSupported
);

Parameters

WowGuestMachine

An IMAGE_FILE_MACHINE_* value that specifies the machine to test.

MachineIsSupported

On success, returns a pointer to a boolean: true if the machine supports WOW64, or false if it does not.

Return Value

On success, returns S_OK; otherwise, returns an error. To get extended error information, call GetLastError.

Remarks

IsWow64GuestMachineSupported is designed for the following scenarios:

  • Debuggers (such as Visual Studio) that want to determine which debugger extensions it needs to install on the system.
  • Apps that need to determine if WOW64 is turned off or not. For example, many apps assume x86-64 systems can always execute x86-32 code at all times, everywhere. Note that this ability does not exist on WinPE or Xbox, and it is an optional component in Server.
  • Test suites that need to achieve full feature coverage by running tests on all supported architectures in the system.

Requirements

   
Windows version Windows 10, version 1709 [desktop apps only] Windows Server 2016 [desktop apps only]
Target Platform Windows
Header wow64apiset.h
Library Kernel32.dll
DLL Kernel32.lib