PathCchRemoveBackslash 函式 (pathcch.h)

從路徑字串結尾移除尾端反斜杠。

此函式與 PathRemoveBackslash 不同,因為它接受具有 “\”、“\?” 和 “\?\UNC” 前置詞的路徑。

注意 此函式或 PathCchRemoveBackslashEx 應該用來取代 PathRemoveBackslash ,以避免緩衝區溢出的可能性。

語法

WINPATHCCHAPI HRESULT PathCchRemoveBackslash(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath
);

參數

[in, out] pszPath

路徑字串的指標。 當此函式成功傳回時,字串會包含已移除任何尾端反斜杠的路徑。 如果找不到尾端反斜杠,則字串不會變更。

[in] cchPath

pszPath 指向的緩衝區大小,以字元為單位。

傳回值

如果函式成功,則此函式會傳回S_OK,S_FALSE字串為根路徑,或找不到反斜杠,否則傳回錯誤碼。

備註

此函式不會從根路徑字串中移除反斜杠,例如 “C:”。

規格需求

需求
最低支援的用戶端 Windows 8 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 pathcch.h
程式庫 Pathcch.lib