Edit

Share via

IsWow64GuestMachineSupported function (wow64apiset.h)

  • Article

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

Syntax

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

Parameters

[in] WowGuestMachine

An IMAGE_FILE_MACHINE_* value that specifies the machine to test.

[out] 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

Requirement Value
Minimum supported client Windows 10, version 1709 [desktop apps only]
Minimum supported server Windows Server 2016 [desktop apps only]
Target Platform Windows
Header wow64apiset.h
Library Kernel32.dll
DLL Kernel32.lib