Поделиться через

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

  • Статья

Добавляет один путь к концу другого.

Эта функция отличается от PathCchAppendEx тем, что вы ограничены конечным путем длины MAX_PATH.

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

Примечание Эту функцию или PathCchAppendEx следует использовать вместо PathAppend , чтобы предотвратить переполнение буфера.

Синтаксис

WINPATHCCHAPI HRESULT PathCchAppend(
  [in, out]      PWSTR  pszPath,
  [in]           size_t cchPath,
  [in, optional] PCWSTR pszMore
);

Параметры

[in, out] pszPath

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

[in] cchPath

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

[in, optional] pszMore

Указатель на путь, добавляемый в конец пути, на который указывает pszPath. UNC-пути и пути, начинающиеся с последовательности "\?", принимаются и распознаются как полные пути. Эти пути заменяют строку, на которую указывает pszPath , а не добавляются к ней.

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

Если эта функция завершается успешно, она возвращает S_OK. В противном случае он возвращает код HRESULT , включая следующий код.

Код возврата Описание
E_INVALIDARG
 PszPath или pszMore имеет значение NULL, cchPath равно 0 или cchPath больше PATHCCH_MAX_CCH.
PATHCCH_E_FILENAME_TOO_LONG
 Итоговая строка превысит PATHCCH_MAX_CCH.
E_OUTOFMEMORY
 Функции не удалось выделить буфер необходимого размера.

Комментарии

Эта функция вставляет обратную косую черту между двумя строками, если она еще отсутствует.

Требования

Требование Значение
Минимальная версия клиента Windows 8 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header pathcch.h
Библиотека Pathcch.lib

См. также раздел

PathCchAppendEx