GetSystemWindowsDirectoryA 函式 (sysinfoapi.h)
擷取多用戶系統上共用 Windows 目錄的路徑。
此函式主要是為了相容性而提供。 應用程式應該將程式代碼儲存在 Program Files 資料夾中,並將持續性資料儲存在使用者配置檔的 Application Data 資料夾中。 如需詳細資訊,請參閱 ShGetFolderPath。
語法
UINT GetSystemWindowsDirectoryA(
[out] LPSTR lpBuffer,
[in] UINT uSize
);
參數
[out] lpBuffer
要接收路徑之緩衝區的指標。 除非 Windows 目錄是根目錄,否則此路徑不會以反斜杠結尾。 例如,如果 Windows 目錄在磁碟驅動器 C 上命名為 Windows,則此函式所擷取的 Windows 目錄路徑為 C:\Windows。 如果系統已安裝在磁碟驅動器 C 的根目錄中,則擷取的路徑為 C:。
[in] uSize
TCHAR中,lpBuffer 參數所指定的緩衝區大小上限。
傳回值
如果函式成功,傳回值會是複製到緩衝區的字串長度,TCHAR,不包含終止的 Null 字元。
如果長度大於緩衝區的大小,則傳回值是保存路徑所需的緩衝區大小。
如果函式失敗,傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
言論
在執行終端機服務的系統上,每個使用者都有唯一的 Windows 目錄。 系統 Windows 目錄是由所有用戶共用,因此它是應用程式應該儲存初始化的目錄,並協助套用至所有使用者的檔案。
使用終端機服務時,GetSystemWindowsDirectory 函式會擷取系統 Windows 目錄的路徑,而 GetWindowsDirectory 函式會擷取每個使用者私用的 Windows 目錄路徑。 在單一用戶系統上,
注意
sysinfoapi.h 標頭會根據 UNICODE 預處理器常數的定義,將 GetSystemWindowsDirectory 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平臺 | 窗戶 |
標頭 | sysinfoapi.h (包括 Windows.h) |
連結庫 | Kernel32.lib |
DLL | Kernel32.dll |