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 WINAPI IsWow64GuestMachineSupported(
  _In_  USHORT  WowGuestMachine,
  _Out_ BOOLEAN *MachineIsSupported
);

Parameters

WowGuestMachine [in]

An IMAGE_FILE_MACHINE_* value that specifies the machine to test.

MachineIsSupported [out]

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

Minimum supported client

Windows 10, version 1709 [desktop apps only]

Minimum supported server

Windows Server 2016 [desktop apps only]

Header

Wow64apiset.h

Library

Kernel32.dll

DLL

Kernel32.lib

 

 

Show: