GetSystemWindowsDirectoryA-Funktion (sysinfoapi.h)

Ruft den Pfad des freigegebenen Windows-Verzeichnisses auf einem Mehrbenutzersystem ab.

Diese Funktion wird in erster Linie aus Gründen der Kompatibilität bereitgestellt. Anwendungen sollten Code im Ordner Programme und persistente Daten im Ordner Anwendungsdaten im Profil des Benutzers speichern. Weitere Informationen finden Sie unter ShGetFolderPath.

Syntax

UINT GetSystemWindowsDirectoryA(
  [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, es sei denn, das Windows-Verzeichnis ist das Stammverzeichnis. Wenn das Windows-Verzeichnis beispielsweise windows auf Laufwerk C heißt, lautet der Pfad des von dieser Funktion abgerufenen Windows-Verzeichnisses C:\Windows. Wenn das System im Stammverzeichnis von Laufwerk C installiert wurde, lautet der abgerufene Pfad C:.

[in] uSize

Die maximale Größe des Puffers, die vom lpBuffer-Parameter in TCHARs angegeben wird.

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.

Hinweise

Auf einem System, auf dem Terminaldienste ausgeführt werden, verfügt jeder Benutzer über ein eindeutiges Windows-Verzeichnis. Das Windows-Systemverzeichnis wird von allen Benutzern gemeinsam genutzt. Daher ist es das Verzeichnis, in dem eine Anwendung Initialisierungs- und Hilfedateien speichern sollte, die für alle Benutzer gelten.

Bei Terminaldiensten ruft die GetSystemWindowsDirectory-Funktion den Pfad des Windows-Systemverzeichnisses ab, während die GetWindowsDirectory-Funktion den Pfad eines Windows-Verzeichnisses abruft, das für jeden Benutzer privat ist. Auf einem Einzelbenutzersystem ist GetSystemWindowsDirectory identisch mit GetWindowsDirectory.

Hinweis

Der sysinfoapi.h-Header definiert GetSystemWindowsDirectory 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 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 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	sysinfoapi.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

GetWindowsDirectory

SHGetFolderLocation

Systeminformationsfunktionen