IsWow64GuestMachineSupported-Funktion (wow64apiset.h)

Bestimmt, welche Architekturen (unter WOW64) für die angegebene Computerarchitektur unterstützt werden.

Syntax

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

Die Parameter

[in] WowGuestMachine

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

[out] MachineIsSupported

Ein Zeiger auf die Variable, die bei Erfolg " true " empfängt, wenn der Computer WOW64 unterstützt, oder "false ", wenn dies nicht der Fall ist.

Rückgabewert

Gibt bei Erfolg S_OK zurück; andernfalls wird ein Fehler zurückgegeben. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

IsWow64GuestMachineSupported wurde für die folgenden Szenarien entwickelt:

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

Anforderungen