Функция PathCchRemoveBackslashEx (pathcch.h)

Удаляет конечную обратную косую черту из конца строки пути.

Эта функция отличается от PathCchRemoveBackslash тем, что она может возвращать указатель на новый конец строки и сообщать о количестве неиспользуемых символов, оставшихся в буфере.

Эта функция отличается от PathRemoveBackslash тем, что она принимает пути с префиксами "\", "\?" и "\?\UNC".

Синтаксис

WINPATHCCHAPI HRESULT PathCchRemoveBackslashEx(
  [in, out]       PWSTR  pszPath,
  [in]            size_t cchPath,
  [out, optional] PWSTR  *ppszEnd,
  [out, optional] size_t *pcchRemaining
);

Параметры

[in, out] pszPath

Указатель на строку пути. При успешном возврате этой функции строка содержит путь с любой конечной обратной косой чертой. Если обратная косая черта в конце не найдена, строка остается неизменной.

[in] cchPath

Размер буфера, на который указывает pszPath, в символах.

[out, optional] ppszEnd

Значение , которое при успешном возврате этой функцией получает адрес указателя на конец новой строки. Если строка является корневым путем, например "C:", указатель указывает на обратную косую черту; В противном случае указатель указывает на завершающий символ NULL строки.

[out, optional] pcchRemaining

Указатель на значение, которое при успешном возврате этой функции получает количество неиспользуемых символов в буфере назначения, включая завершающий символ NULL. Если строка является корневым путем, например "C:", это число включает обратную косую черту в этой строке.

Возвращаемое значение

Эта функция возвращает S_OK , если функция была успешной, S_FALSE , является ли строка корневым путем, если обратная косая черта не найдена, или код ошибки в противном случае.

Комментарии

Эта функция не удаляет обратную косую черту из строки корневого пути, например "C:".

Требования