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 |