GetSystemWindowsDirectoryA-Funktion (sysinfoapi.h)
Ruft den Pfad des freigegebenen Windows-Verzeichnisses auf einem Mehrbenutzersystem ab.
Diese Funktion wird hauptsächlich aus Kompatibilitätsgründen bereitgestellt. Anwendungen sollten Code im Ordner "Programme" und beständigen Daten im Ordner "Anwendungsdaten" im Benutzerprofil 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 z. B. das Windows-Verzeichnis 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 durch den parameter lpBuffer angegebenen Puffers in TCHARs.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Länge der Zeichenfolge, die in den Puffer kopiert wurde, in TCHARs, nicht einschließlich des endenden NULL-Zeichens.
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 einem System, das Terminaldienste ausführt, verfügt jeder Benutzer über ein eindeutiges Windows-Verzeichnis. Das Windows-Systemverzeichnis wird von allen Benutzern gemeinsam verwendet. Daher ist es das Verzeichnis, in dem eine Anwendung Initialisierungs- und Hilfedateien speichern soll, die für alle Benutzer gelten.
Mit 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. Bei einem Einzelbenutzersystem ist GetSystemWindowsDirectory- mit GetWindowsDirectory-identisch.
Anmerkung
Der sysinfoapi.h-Header definiert GetSystemWindowsDirectory 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 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 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | sysinfoapi.h (include Windows.h) |
| Library | Kernel32.lib |
| DLL- | Kernel32.dll |