IsWow64GuestMachineSupported-Funktion (wow64apiset.h)

  • Artikel

Bestimmt, welche Architekturen (unter WOW64) auf der angegebenen Computerarchitektur unterstützt werden.

Syntax

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

Parameter

[in] WowGuestMachine

Ein IMAGE_FILE_MACHINE_* -Wert, der den zu testenden Computer angibt.

[out] MachineIsSupported

Gibt bei Erfolg einen Zeiger auf einen booleschen Wert zurück: true , wenn der Computer WOW64 unterstützt, oder false , wenn dies nicht der Fall ist.

Rückgabewert

Gibt bei Erfolg S_OK zurück. Gibt andernfalls einen Fehler zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

IsWow64GuestMachineSupported ist für die folgenden Szenarien konzipiert:

  • Debugger (z. B. Visual Studio), die ermitteln möchten, welche Debuggererweiterungen auf dem System installiert werden müssen.
  • Apps, die feststellen müssen, ob WOW64 deaktiviert ist oder nicht. Viele Apps gehen beispielsweise davon aus, dass x86-64-Systeme jederzeit und überall x86-32-Code ausführen können. Beachten Sie, dass diese Funktion auf WinPE oder Xbox nicht vorhanden ist und eine optionale Komponente in Server ist.
  • Testsammlungen, die eine vollständige Featureabdeckung erreichen müssen, indem Tests für alle unterstützten Architekturen im System ausgeführt werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1709 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2016 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wow64apiset.h
Bibliothek Kernel32.dll
DLL Kernel32.lib