GetSystemDirectoryA-Funktion (sysinfoapi.h)
Ruft den Pfad des Systemverzeichnisses ab. Das Systemverzeichnis enthält Systemdateien wie Dynamic Link-Bibliotheken und Treiber.
Diese Funktion wird hauptsächlich aus Kompatibilitätsgründen bereitgestellt. Anwendungen sollten Code im Ordner "Programme" und persistente Daten im Ordner Anwendungsdaten im Benutzerprofil speichern. Weitere Informationen finden Sie unter ShGetFolderPath.
Syntax
UINT GetSystemDirectoryA(
[out] LPSTR lpBuffer,
[in] UINT uSize
);
Parameter
[out] lpBuffer
Ein Zeiger auf den Puffer, der den Pfad empfangen soll. Dieser Pfad endet nicht mit einem umgekehrten Schrägstrich, es sei denn, das Systemverzeichnis ist das Stammverzeichnis. Wenn das Systemverzeichnis beispielsweise auf Laufwerk C den Namen Windows\System32 trägt, lautet der Pfad des systemverzeichnisses, das von dieser Funktion abgerufen wird, C:\Windows\System32.
[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 abschließende NULL-Zeichen. Wenn die Länge größer als die Größe des Puffers ist, entspricht der Rückgabewert der Größe des Puffers, der zum Speichern des Pfads erforderlich ist, einschließlich des abschließenden NULL-Zeichens.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Anwendungen sollten keine Dateien im Systemverzeichnis erstellen. Wenn der Benutzer eine freigegebene Version des Betriebssystems ausführt, hat die Anwendung keinen Schreibzugriff auf das Systemverzeichnis.
Beispiele
Ein Beispiel finden Sie unter Abrufen von Systeminformationen.
Hinweis
Der sysinfoapi.h-Header definiert GetSystemDirectory 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | sysinfoapi.h (windows.h einschließen) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |