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

Siehe auch

GetCurrentDirectory

GetWindowsDirectory

SetCurrentDirectory

Systeminformationsfunktionen