GetSystemDirectoryA-Funktion (sysinfoapi.h)
Ruft den Pfad des Systemverzeichnisses ab. Das Systemverzeichnis enthält Systemdateien wie Dynamic Link Libraries und Treiber.
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 GetSystemDirectoryA(
[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 Systemverzeichnis ist das Stammverzeichnis. Wenn das Systemverzeichnis beispielsweise "Windows\System32" auf Laufwerk C heißt, lautet der Pfad des von dieser Funktion abgerufenen Systemverzeichnisses "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 in TCHARsder in den Puffer kopierten Zeichenfolge, nicht einschließlich des endenden Nullzeichens. 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, einschließlich des endenden Nullzeichens.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
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.
Anmerkung
Der sysinfoapi.h-Header definiert GetSystemDirectory 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 [Desktop-Apps | UWP-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [Desktop-Apps | UWP-Apps] |
| Zielplattform- | Fenster |
| Header- | sysinfoapi.h (include Windows.h) |
| Library | Kernel32.lib |
| DLL- | Kernel32.dll |