GetSystemWow64Directory2A-Funktion (wow64apiset.h)

  • Artikel

Ruft den Pfad des von WOW64 verwendeten Systemverzeichnisses unter Verwendung 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, der den Pfad empfangen soll. 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 der in den Puffer kopierten Zeichenfolge in TCHARs, ohne das abschließende NULL-Zeichen. 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 fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

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

WOW64 verwendet das Systemverzeichnis, um freigegebenen 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.

Hinweis

Der Wow64apiset.h-Header 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

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

Weitere Informationen

GetSystemWow64Directory