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

Функция StrCatChainW (shlwapi.h)

  • Статья

Объединяет две строки Юникода. Используется, когда требуются повторяющиеся объединения с тем же буфером.

Синтаксис

DWORD StrCatChainW(
  [out] PWSTR  pszDst,
        DWORD  cchDst,
        DWORD  ichAt,
  [in]  PCWSTR pszSrc
);

Параметры

[out] pszDst

Тип: PWSTR

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

cchDst

Тип: DWORD

Размер буфера назначения в символах. Этот буфер должен иметь достаточный размер для хранения обеих строк, а также завершающего символа NULL. Если буфер слишком мал, последняя строка усекается.

ichAt

Тип: DWORD

Смещение в буфер назначения, с которого начинается действие добавления. Если строка не пуста, присвойте этому значению значение -1, чтобы вычислить текущее количество заполненных символов (не включая завершающий пустой символ).

[in] pszSrc

Тип: PCWSTR

Указатель на исходную строку Юникода, завершаемую null.

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

Тип: DWORD

Возвращает смещение пустого символа после последнего символа, добавленного в pszDst.

Комментарии

Предупреждение системы безопасности: Неправильное использование этой функции может поставить под угрозу безопасность приложения. Окончательная строка не гарантируется, что она будет заканчиваться null. Рассмотрите возможность использования одного из следующих вариантов: StringCbCatEx, StringCbCatNEx, StringCchCatEx или StringCchCatNEx. Прежде чем продолжить, ознакомьтесь с рекомендациями по безопасности: Microsoft Windows Shell .

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header shlwapi.h
Библиотека Shlwapi.lib
DLL Shlwapi.dll (версия 5.5 или более поздняя)