Windows API 獲取系統路徑

每次寫代碼獲取系統路徑都是要百度一番，之前都記不住API，也沒刻意去記住這些API。

但是這樣每次開發效率就比較低，所以還是整理下吧，加深下印象，至少後面可以在自己博客裏就能輕鬆的找到了吧。

 

直接上代碼吧。

#include "stdafx.h"
#include <Shlobj.h>
#include <tchar.h>
#include <Windows.h>
#include <vector>

#define MAKE_PAIR(id) (std::pair<int, const TCHAR *>(id, _T(#id)))

void PrintSpecailFolder() {
  TCHAR szPath[MAX_PATH];

  // CSIDL列表：https://docs.microsoft.com/zh-cn/windows/win32/shell/csidl
  std::vector<std::pair<int, const TCHAR *>> id_name_list = {
      MAKE_PAIR(CSIDL_ADMINTOOLS),
      MAKE_PAIR(CSIDL_APPDATA),
      MAKE_PAIR(CSIDL_CDBURN_AREA),
      MAKE_PAIR(CSIDL_COMMON_ADMINTOOLS),
      MAKE_PAIR(CSIDL_COMMON_APPDATA),
      MAKE_PAIR(CSIDL_COMMON_DESKTOPDIRECTORY),
      MAKE_PAIR(CSIDL_COMMON_DOCUMENTS),
      MAKE_PAIR(CSIDL_COMMON_FAVORITES),
      MAKE_PAIR(CSIDL_COMMON_MUSIC),
      MAKE_PAIR(CSIDL_COMMON_PICTURES),
      MAKE_PAIR(CSIDL_COMMON_PROGRAMS),
      MAKE_PAIR(CSIDL_COMMON_STARTMENU),
      MAKE_PAIR(CSIDL_COMMON_STARTUP),
      MAKE_PAIR(CSIDL_COMMON_TEMPLATES),
      MAKE_PAIR(CSIDL_COMMON_VIDEO),
      MAKE_PAIR(CSIDL_COOKIES),
      MAKE_PAIR(CSIDL_FAVORITES),
      MAKE_PAIR(CSIDL_HISTORY),
      MAKE_PAIR(CSIDL_INTERNET_CACHE),
      MAKE_PAIR(CSIDL_LOCAL_APPDATA),
      MAKE_PAIR(CSIDL_MYDOCUMENTS),
      MAKE_PAIR(CSIDL_MYMUSIC),
      MAKE_PAIR(CSIDL_MYPICTURES),
      MAKE_PAIR(CSIDL_MYVIDEO),
      MAKE_PAIR(CSIDL_PROFILE),
      MAKE_PAIR(CSIDL_PROGRAM_FILES),
      MAKE_PAIR(CSIDL_PROGRAM_FILES_COMMON),
      MAKE_PAIR(CSIDL_PROGRAMS),
      MAKE_PAIR(CSIDL_RECENT),
      MAKE_PAIR(CSIDL_SENDTO),
      MAKE_PAIR(CSIDL_STARTMENU),
      MAKE_PAIR(CSIDL_STARTUP),
      MAKE_PAIR(CSIDL_SYSTEM),
      MAKE_PAIR(CSIDL_TEMPLATES),
      MAKE_PAIR(CSIDL_WINDOWS)};

  size_t nSize = id_name_list.size();
  for (size_t i = 0; i < nSize; ++i) {
    const std::pair<int, const TCHAR *> &item = id_name_list.at(i);
    if (SUCCEEDED(SHGetFolderPath(NULL, item.first, NULL, SHGFP_TYPE_CURRENT,
                                  szPath))) {
      TCHAR buffer[MAX_PATH] = {0};
      _tcscat_s(buffer, item.second);
      _tcscat_s(buffer, _T("\t\t->\t\t"));
      _tcscat_s(buffer, szPath);
      _tcscat_s(buffer, _T("\r\n"));
      ::OutputDebugString(buffer);
    }
  }
}

 

運行結果如下：

CSIDL_ADMINTOOLS->C:\Users\username\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Administrative Tools
CSIDL_APPDATA                    ->        C:\Users\username\AppData\Roaming
CSIDL_CDBURN_AREA                ->        C:\Users\username\AppData\Local\Microsoft\Windows\Burn\Burn
CSIDL_COMMON_ADMINTOOLS     ->  C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Administrative Tools
CSIDL_COMMON_APPDATA            ->        C:\ProgramData
CSIDL_COMMON_DESKTOPDIRECTORY    ->        C:\Users\Public\Desktop
CSIDL_COMMON_DOCUMENTS            ->        C:\Users\Public\Documents
CSIDL_COMMON_FAVORITES            ->        D:\Documents\Favorites
CSIDL_COMMON_MUSIC                ->        C:\Users\Public\Music
CSIDL_COMMON_PICTURES            ->        C:\Users\Public\Pictures
CSIDL_COMMON_PROGRAMS            ->        C:\ProgramData\Microsoft\Windows\Start Menu\Programs
CSIDL_COMMON_STARTMENU            ->        C:\ProgramData\Microsoft\Windows\Start Menu
CSIDL_COMMON_STARTUP            ->        C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup
CSIDL_COMMON_TEMPLATES            ->        C:\ProgramData\Microsoft\Windows\Templates
CSIDL_COMMON_VIDEO                ->        C:\Users\Public\Videos
CSIDL_COOKIES                    ->        C:\Users\username\AppData\Local\Microsoft\Windows\INetCookies
CSIDL_FAVORITES                    ->        D:\Documents\Favorites
CSIDL_HISTORY                    ->        C:\Users\username\AppData\Local\Microsoft\Windows\History
CSIDL_INTERNET_CACHE            ->        C:\Users\username\AppData\Local\Microsoft\Windows\INetCache
CSIDL_LOCAL_APPDATA                ->        C:\Users\username\AppData\Local
CSIDL_MYDOCUMENTS                ->        D:\Documents
CSIDL_MYMUSIC                    ->        D:\Documents\Music
CSIDL_MYPICTURES                ->        D:\Documents\Pictures
CSIDL_MYVIDEO                    ->        D:\Documents\Videos
CSIDL_PROFILE                    ->        C:\Users\username
CSIDL_PROGRAM_FILES                ->        C:\Program Files (x86)
CSIDL_PROGRAM_FILES_COMMON        ->        C:\Program Files (x86)\Common Files
CSIDL_PROGRAMS                    ->        C:\Users\username\AppData\Roaming\Microsoft\Windows\Start Menu\Programs
CSIDL_RECENT                    ->        C:\Users\username\AppData\Roaming\Microsoft\Windows\Recent
CSIDL_SENDTO                    ->        C:\Users\username\AppData\Roaming\Microsoft\Windows\SendTo
CSIDL_STARTMENU                    ->        C:\Users\username\AppData\Roaming\Microsoft\Windows\Start Menu
CSIDL_STARTUP                    ->        C:\Users\username\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup
CSIDL_SYSTEM                    ->        C:\Windows\system32
CSIDL_TEMPLATES              ->        C:\Users\username\AppData\Roaming\Microsoft\Windows\Templates
CSIDL_WINDOWS                    ->        C:\Windows

 

上面中常用的幾個路徑標紅了，方便後面查閱方便。

其中有三個路徑容易搞混（都包含了APPDATA），特別說明下，免得後面每次使用的時候都要測試一下。

• CSIDL_COMMON_APPDATA            ->        C:\ProgramData
• CSIDL_APPDATA                               ->        C:\Users\username\AppData\Roaming
• CSIDL_LOCAL_APPDATA                 ->        C:\Users\username\AppData\Local

第一個是和用戶無關的路徑，一般是存放和用戶無關的信息。

第二個是%appdata%環境變量所指的路徑。沒有用戶登錄看到的是不同的內容，username就是當前登錄用戶名稱。

第三個是%appdata%父目錄下的一個目錄。和第二個類似，也適合用戶相關的。

 

代碼中使用的是SHGetFolderPath這個API，msdn說明如下：

https://docs.microsoft.com/zh-cn/windows/win32/api/shlobj_core/nf-shlobj_core-shgetfolderpatha

還有另外一個API也可以，不過不再推薦使用了，就是SHGetSpecialFolderPath這個API。

msdn說明如下：

https://docs.microsoft.com/en-us/windows/win32/api/shlobj_core/nf-shlobj_core-shgetspecialfolderpatha

使用這個函數實現獲取系統路徑的用法如下：
    wchar_t buff[MAX_PATH] = { 0 };
    SHGetSpecialFolderPath(NULL, buff, CSIDL_LOCAL_APPDATA, false);

注意：這兩個API獲取的路徑字符串都沒有最後的反斜槓！！！  參考msdn的文檔說明如下：

pszPath

Type: LPTSTR

A pointer to a null-terminated string of length MAX_PATH which will receive the path. If an error occurs or S_FALSE is returned, this string will be empty. The returned path does not include a trailing backslash. For example, "C:\Users" is returned rather than "C:\Users\".

 

代碼中爲了偷懶，定義了一個宏MAKE_PAIR，是利用了C語言的宏特性，# 能把一個符號變成字符串，免得生成std::pair的時候回重複寫一些CSIDL的值。