GetSystemWow64DirectoryA-Funktion (wow64apiset.h)

  • Artikel

Ruft den Pfad des von WOW64 verwendeten Systemverzeichnisses ab. Dieses Verzeichnis ist unter 32-Bit-Windows nicht vorhanden.

Syntax

UINT GetSystemWow64DirectoryA(
  [out] LPSTR lpBuffer,
  [in]  UINT  uSize
);

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.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Länge der in den Puffer kopierten Zeichenfolge in TCHARs, ohne das beendende 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.

Unter 32-Bit-Windows schlägt die Funktion immer fehl, und der erweiterte Fehler ist auf ERROR_CALL_NOT_IMPLEMENTED festgelegt.

Hinweise

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.

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0501 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Hinweis

Der wow64apiset.h-Header definiert GetSystemWow64Directory als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wow64apiset.h (einschließlich Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

Systeminformationsfunktionen