GetSystemDirectory

von ActiveVB-Team

Deklaration

Declare Function GetSystemDirectory Lib "kernel32" _
                 Alias "GetSystemDirectoryA" ( _
                 ByVal lpBuffer As String, _
                 ByVal nSize As Long) As Long

Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel GetSystemDirectory des API-Wikis.

GetSystemDirectory ermittelt den Namen des Windows-Systemverzeichnisses. Dabei handelt es sich um das Verzeichnis, indem Schriften, Icon-Bibliotheken oder DLLs abgelegt werden.

Parameter
lpBuffer	Zeiger auf einen Puffer, der den Namen des Systemverzeichnisse aufnimmt. Da ein ein Verzeichnisname MAX_PATH lang sein kann, sollte der Puffer auf MAX_PATH + 1 gesetzt werden.
nSize	Die Größe des Puffer, der den Namen des Windows-Systemverzeichnisses aufnimmt.

Tabelle 1

Rückgabewerte
uInt	Die Anzahl der Zeichen, die in den Puffer geschrieben wurden. Wenn die Funktion fehlschlägt, weil der Puffer zu klein dimensioniert war, gibt der Rückgabewert an, wieviele Bytes erforderlich sind um den Namen des Systemverzeichnisses aufzunehmen. Dieser Wert berücksichtigt das Nullzeichen, das den String abschließt. Mit GetLastError wird festgestellt, ob der Rückgabewert diese Fehlerbedingung anzeigt, oder ob die Funktion erfolgreich war.
0	Es lag ein Fehler vor.

Rückgabewerte

uInt

Die Anzahl der Zeichen, die in den Puffer geschrieben wurden. Wenn die Funktion fehlschlägt, weil der Puffer zu klein dimensioniert war, gibt der Rückgabewert an, wieviele Bytes erforderlich sind um den Namen des Systemverzeichnisses aufzunehmen. Dieser Wert berücksichtigt das Nullzeichen, das den String abschließt. Mit GetLastError wird festgestellt, ob der Rückgabewert diese Fehlerbedingung anzeigt, oder ob die Funktion erfolgreich war.

Es lag ein Fehler vor.

Tabelle 2

Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
GetCurrentDirectory, GetWindowsDirectory, SetCurrentDirectory

Zugehörige Tipps

Icons aus einer DLL extrahieren [Tipp 0131]

Zugehörige Microsoft Knowledge Base Artikel