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


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

Добавляет одну строку в другую.

Примечание Не используйте. Дополнительные функции см. в разделе Примечания.
 

Синтаксис

PWSTR StrCatW(
  [in, out] PWSTR  psz1,
  [in]      PCWSTR psz2
);

Параметры

[in, out] psz1

Тип: PTSTR

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

[in] psz2

Тип: PCTSTR

Указатель на строку, завершаемую null, которая добавляется в psz1.

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

Тип: PTSTR

Возвращает указатель на psz1, который содержит объединенные строки.

Комментарии

Предупреждение системы безопасности: Неправильное использование этой функции может поставить под угрозу безопасность приложения. Первый аргумент, psz1, должен быть достаточно большим, чтобы вместить psz2 и закрывающий "\0", в противном случае может произойти переполнение буфера. Переполнение буфера может привести к атаке типа "отказ в обслуживании" в приложении в случае нарушения доступа. В худшем случае переполнение буфера может позволить злоумышленнику внедрить исполняемый код в процесс, особенно если psz1 является буфером на основе стека. Рассмотрите возможность использования одной из следующих альтернатив: StringCbCat, StringCbCatEx, StringCbCatN, StringCbCatNEx, StringCchCat, StringCchCatEx, StringCchCatN или StringCchCatNEx. Прежде чем продолжить, ознакомьтесь с разделом Вопросы безопасности: Оболочка Microsoft Windows .

Требования

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