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 |