Функция lstrcat


Функция lstrcat добавляет в конец одной строки другую строку.

Синтаксис

LPTSTR lstrcat(      

    LPTSTR lpString1,
    LPTSTR lpString2
);

Параметры

lpString1

[in, out] Указатель на строку с завершающим нулем. Буфер должен быть достаточно большим, чтобы содержать в себе обе строки.

lpString2

[in] Указатель на строку с завершающим нулем, которая будет добавлена в конец строки, указанной в параметре lpString1.

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

Если функция завершается успешно, возвращаемое значение - указатель на буфер.

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

Замечания

Предупреждение защиты  Используя эту функцию неправильно можно поставить под угрозу обеспечение безопасности Вашего приложения.

Эта функция использует структурную обработку исключений (SEH), чтобы перехватывать нарушения прав доступа и другие ошибки. Когда эта функция отлавливает ошибки структурной обработки исключений (SEH), она возвращает значение NULL, не завершая символом конца строки ('\0') строку и не уведомляя вызывающую программу об ошибке. Вызывающая программа не защищена от предположения, что недостаточное место - сбойная ситуация.

Первый параметр, lpString1, должен быть достаточно большим, чтобы вместить lpString2 и завершение '\0', в противном случае может произойти переполнение буфера. Переполнение буфера может привести к атаке типа "отказ в обслуживании" опираясь на приложение, если имеет место нарушение прав доступа. В худшем случае, переполнение буфера может дать возможность взломщику защиты вставить исполняемый код в Ваш процесс, особенно если lpString1 - буфер, работающий со стеком.

Рассмотрите использование функции: StringCchCat.

Перед продолжением работы прочитайте Рассмотрение вопроса обеспечения безопасности: Пользовательский интерфейс Windows.

Windows 95/98/Me: lstrcatW поддерживается программой Microsoft Layer for Unicode (MSLU). Хотя версия W уже существует в Microsoft Windows 98/Me, она включается, чтобы обеспечить более непротиворечивое поведение во всех операционных системах Windows. Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.

Пример

Пример смотри в статье Чтение из почтовой ячейки.

Смотри также

Обзор Строки, Функции, используемые строками, StringCbCat, StringCbCatEx, StringCbCatN, StringCbCatNEx, StringCchCat, StringCchCatEx, StringCchCatN, StringCchCatNEx, lstrcmp, lstrcmpi, lstrcpy, lstrlen

Размещение и совместимость lstrcat

К Windows XP Да
л Windows 2000 Professional Да
и Windows NT Workstation Да версии 3.1
е Windows Me Да
н Windows 98 Да
т Windows 95 Да
С Windows Server 2003 Да
е Windows 2000 Server Да
р Windows NT Server Да версии 3.1
в
е
р
Используемая библиотека Kernel32.lib
Используемая DLL kernel32.dll
Заголовочный файл
- объявлено в Winbase.h
- включено в Windows.h
Unicode Реализуются как версии Unicode и ANSI.
Замечания по платформе Не имеется

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz