PathProcessCommand 函式 (shlobj.h)
已取代。 處理包含命令行並產生適當引號字串的字串,並視需要附加自變數。
語法
LONG PathProcessCommand(
[in] PCWSTR pszSrc,
[out] PWSTR pszDest,
int cchDest,
DWORD dwFlags
);
參數
[in] pszSrc
類型: PCWSTR
包含要處理的命令行之 Null 終止字串的指標。
[out] pszDest
類型: PWSTR
緩衝區的指標,該緩衝區會以適當的引號接收以 Null 終止的 Unicode 字串。 若要判斷這個緩衝區必須有多大,請將此參數設定為 NULL。 函式會傳回所需的緩衝區大小。
cchDest
類型: int
可以放在 pszDest 中的字元數目上限,不包括終止的 Null 字元。 如果此值太小,函式就會失敗。
dwFlags
類型: DWORD
控制程式的旗標。 下列一或多個值:
PPCF_ADDQUOTES (0x00000001)
如果路徑需要引號,請新增引號。
PPCF_ADDARGUMENTS (0x00000003)
將尾端自變數附加至輸出字串。 此值包含 PPCF_ADDQUOTES。
PPCF_NODIRECTORIES (0x00000010)
不比對輸入字串與資料夾,僅適用於檔案物件。
PPCF_FORCEQUALIFY (0x00000040)
限定甚至是非相對檔名。
PPCF_LONGESTPOSSIBLE (0x00000080)
一律選擇最長可能的可執行檔名稱。
傳回值
類型: LONG
如果成功,則傳回正值。 如果 lpDest 設定為 NULL,函式會以字元傳回必要的緩衝區大小,包括終止的 Null 字元。 如果呼叫失敗,函式會傳回負值。
備註
注意 此函式可透過 Windows XP Service Pack 2 (SP2) 和 Windows Server 2003 取得。 Windows Vista 和更新版本的 Windows 不支援。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | shlobj.h |
程式庫 | Shell32.lib |
Dll | Shell32.dll (5.0 版或更新版本) |