PathCchFindExtension 函式 (pathcch.h)
搜尋路徑以尋找其擴展名,例如 「.exe」 或 「.ini」。 此函式不會搜尋特定延伸模組;它會搜尋是否有任何擴充功能。
此函式與 PathFindExtension 不同,因為它接受具有 “\”、“\?” 和 “\?\UNC” 前置詞的路徑。
注意 此函式應該用來取代 PathFindExtension ,以避免發生緩衝區溢出的可能性。
語法
WINPATHCCHAPI HRESULT PathCchFindExtension(
[in] PCWSTR pszPath,
[in] size_t cchPath,
[out] PCWSTR *ppszExt
);
參數
[in] pszPath
要搜尋之路徑的指標。
[in] cchPath
pszPath 以字元表示的緩衝區大小,包括 Null 終止符。
[out] ppszExt
當此函式成功傳回時,指標的位址會指向 pszPath 中延伸模組前面的 “.” 字元。 如果找不到擴充功能,則會指向字串的終止 Null 字元。
傳回值
如果此函式成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2012 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | pathcch.h |
程式庫 | Pathcch.lib |