![[en]](../../img/flags/en.png)
In English
GetSpecialFolderPath
Gibt den Pfad zum angegebenen speziellen Systemordner aus.
Archivierter Inhalt: Dieser Quelltext ist derzeit inaktiv und möglicherweise veraltet, nicht mehr gewartet oder funktioniert nicht mehr.
Die speziellen Verzeichnisse für Programmdateien, Benutzerdokumente oder andere Einstellungen lauten im Zweifel auf jedem System ein bisschen anders. Sie fest im Programm anzugeben hat schon zu einigen Fehlern geführt und ist generell keine praktikable Lösung. Die GetSpecialFolderPath-Funktion nimmt dem Programmierer auch die letzte Schreibarbeit ab und lässt keine Entschuldigungen mehr zu, Programme zu schreiben, die nur in bestimmten Windows-Versionen oder -Sprachen funktionieren.
Diese Funktion ist mit der .NET-Funktion Environment.GetFolderPath vergleichbar.
Hinweis zur Codequalität: Der Inhalt auf dieser Seite ist möglicherweise etwas angestaubt. Ich nutze C++ seit längerer Zeit nicht mehr, möchte aber die vorhandenen und früher einmal nützlichen Funktionen weiterhin anbieten.
Download
GetSpecialFolderPath.cpp4,9 KiBQuelltext der GetSpecialFolderPath-Funktion
Inhalt der Datei GetSpecialFolderPath.cpp:
// parameter value.
//
// Dependencies: CString
//
// Web: http://unclassified.software/source/getspecialfolderpath
// SystemDir defines
#define SD_ROOT 0x0100
#define SD_WIN 0x0101
#define SD_SYS 0x0102
// params used for SHGetSpecialFolderPath
// only available with shell32.dll v4.71+
// copied from pladform sdk shlobj.h (SD_* was originally CSIDL_*)
// remarked values return no filesystem path
#define SD_DESKTOP 0x0000 // <desktop>
#define SD_PROGRAMS 0x0002 // Start Menu\Programs
#define SD_PERSONAL 0x0005 // My Documents
#define SD_FAVORITES 0x0006 // <user name>\Favorites
#define SD_STARTUP 0x0007 // Start Menu\Programs\Startup
#define SD_RECENT 0x0008 // <user name>\Recent
#define SD_SENDTO 0x0009 // <user name>\SendTo
#define SD_STARTMENU 0x000b // <user name>\Start Menu
#define SD_DESKTOPDIRECTORY 0x0010 // <user name>\Desktop
#define SD_NETHOOD 0x0013 // <user name>\nethood
#define SD_FONTS 0x0014 // windows\fonts
#define SD_TEMPLATES 0x0015
#define SD_COMMON_STARTMENU 0x0016 // All Users\Start Menu
#define SD_COMMON_PROGRAMS 0X0017 // All Users\Programs
#define SD_COMMON_STARTUP 0x0018 // All Users\Startup
#define SD_COMMON_DESKTOPDIRECTORY 0x0019 // All Users\Desktop
#define SD_APPDATA 0x001a // <user name>\Application Data
#define SD_PRINTHOOD 0x001b // <user name>\PrintHood
#define SD_LOCAL_APPDATA 0x001c // <user name>\Local Settings\Application Data (non roaming)
#define SD_COMMON_FAVORITES 0x001f
#define SD_INTERNET_CACHE 0x0020
#define SD_COOKIES 0x0021
#define SD_HISTORY 0x0022
#define SD_COMMON_APPDATA 0x0023 // All Users\Application Data
#define SD_WINDOWS 0x0024 // GetWindowsDirectory()
#define SD_SYSTEM 0x0025 // GetSystemDirectory()
#define SD_PROGRAM_FILES 0x0026 // C:\Program Files
#define SD_MYPICTURES 0x0027 // C:\Program Files\My Pictures
#define SD_PROFILE 0x0028 // USERPROFILE
#define SD_SYSTEMX86 0x0029 // x86 system directory on RISC
#define SD_PROGRAM_FILESX86 0x002a // x86 C:\Program Files on RISC
#define SD_PROGRAM_FILES_COMMON 0x002b // C:\Program Files\Common
#define SD_PROGRAM_FILES_COMMONX86 0x002c // x86 Program Files\Common on RISC
#define SD_COMMON_TEMPLATES 0x002d // All Users\Templates
#define SD_COMMON_DOCUMENTS 0x002e // All Users\Documents
#define SD_COMMON_ADMINTOOLS 0x002f // All Users\Start Menu\Programs\Administrative Tools
#define SD_CONNECTIONS 0x0031 // Network and Dial-up Connections
//#define SD_INTERNET 0x0001 // Internet Explorer (icon on desktop)
//#define SD_CONTROLS 0x0003 // My Computer\Control Panel
//#define SD_PRINTERS 0x0004 // My Computer\Printers
//#define SD_BITBUCKET 0x000a // <desktop>\Recycle Bin
//#define SD_DRIVES 0x0011 // My Computer
//#define SD_NETWORK 0x0012 // Network Neighborhood
//#define SD_ALTSTARTUP 0x001d // non localized startup
//#define SD_COMMON_ALTSTARTUP 0x001e // non localized common startup
//#define SD_ADMINTOOLS 0x0030 // <user name>\Start Menu\Programs\Administrative Tools
#define SD_FLAG_CREATE 0x8000 // combine with SD_ value to force folder creation in SHGetFolderPath()
#define SD_FLAG_DONT_VERIFY 0x4000 // combine with SD_ value to return an unverified folder path
#define SD_FLAG_MASK 0xFF00 // mask for all possible flag values
// runtime function
typedef BOOL (WINAPI *SHGETSPECIALFOLDERPATH)(HWND hwndOwner, LPTSTR lpszPath, int nFolder, BOOL fCreate);
SHGETSPECIALFOLDERPATH pSHGetSpecialFolderPath = 0;
// initialisation needed!
HMODULE hShellDLL = LoadLibrary("shell32.dll");
if (hShellDLL)
{
pSHGetSpecialFolderPath =
(SHGETSPECIALFOLDERPATH) GetProcAddress(hShellDLL, "SHGetSpecialFolderPathA");
}
// free module when finished!
FreeLibrary(hShellDLL);
CString GetSpecialFolderPath(int iType)
{
CString str;
int i = MAX_PATH + 1;
switch (iType)
{
case SD_ROOT:
str = GetSpecialFolderPath(SD_WIN);
str = str.Left(3);
break;
case SD_WIN:
GetWindowsDirectory(str.GetBuffer(i), i);
str.ReleaseBuffer();
break;
case SD_SYS:
GetSystemDirectory(str.GetBuffer(i), i);
str.ReleaseBuffer();
break;
default:
if (pSHGetSpecialFolderPath)
{
pSHGetSpecialFolderPath(NULL, str.GetBuffer(MAX_PATH + 1), iType, FALSE);
str.ReleaseBuffer();
}
else
{
str = "";
}
break;
}
return str;
}
Lizenz und Nutzungsbedingungen
Diese Software ist als kompilierte Version und im Quelltext frei und uneingeschränkt verfügbar („Public Domain“). Ich gebe keine Garantie, auch nicht auf Lauffähigkeit oder Benutzbarkeit. Die Nutzung erfolgt auf eigene Gefahr, ich hafte nicht für Schäden, die durch sachgemäßen oder unsachgemäßen Gebrauch dieses Programms entstehen.
Statistische Daten
- Erstellt am 2007-04-02.