Freigeben über


GetSystemWow64Directory2A-Funktion (wow64apiset.h)

Ruft den Pfad des Von WOW64-verwendeten Systemverzeichnisses mithilfe des angegebenen Imagedateicomputertyps ab. Dieses Verzeichnis ist unter 32-Bit-Windows nicht vorhanden.

Syntax

UINT GetSystemWow64Directory2A(
  [out] LPSTR lpBuffer,
  [in]  UINT  uSize,
  [in]  WORD  ImageFileMachineType
);

Parameter

[out] lpBuffer

Ein Zeiger auf den Puffer, um den Pfad zu empfangen. Dieser Pfad endet nicht mit einem umgekehrten Schrägstrich.

[in] uSize

Die maximale Größe des Puffers in TCHARs.

[in] ImageFileMachineType

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

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Länge in TCHARsder in den Puffer kopierten Zeichenfolge, nicht einschließlich des endenden Nullzeichens. Wenn die Länge größer als die Größe des Puffers ist, ist der Rückgabewert die Größe des Puffers, der zum Speichern des Pfads erforderlich ist.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Auf Systemen, die mehrere WOW64 Architekturen unterstützen, können Sie GetSystemWow64Directory2 verwenden, um das entsprechende Systemverzeichnis abzurufen, das der WOW64-Architektur zugeordnet ist, die durch ImageFileMachineTypeangegeben wird.

WOW64 verwendet das Systemverzeichnis, um gemeinsam genutzten 32-Bit-Code unter 64-Bit-Windows zu speichern. Die meisten Anwendungen müssen nicht explizit auf dieses Verzeichnis zugreifen.

Weitere Informationen zu WOW64 finden Sie unter Ausführen von 32-Bit-Anwendungen.

Anmerkung

Der header wow64apiset.h definiert GetSystemWow64Directory2 als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 10, Version 1511 [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2016 [nur Desktop-Apps]
Zielplattform- Fenster
Header- wow64apiset.h
Library Kernel32.dll
DLL- Kernel32.lib

Siehe auch

GetSystemWow64Directory