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

Статья
11/20/2024

Добавляет указанное число символов с начала одной строки к концу другого.

Примечание Не используйте эту функцию или макрос StrCat N. См. примечания для альтернативных функций.

Синтаксис

PSTR StrNCatA(
  [in, out] PSTR  psz1,
            PCSTR psz2,
            int   cchMax
);

Параметры

[in, out] psz1

Тип: PTSTR

Указатель на строку, завершающуюся значением NULL, к которой функция добавляет символы из psz2. Оно должно быть достаточно большим, чтобы содержать объединенные строки, а также завершающий символ NULL.

psz2

Тип: PCTSTR

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

cchMax

Тип: int

Число символов, добавляемых к psz1 с начала psz2.

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

Тип: PTSTR

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

Замечания

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

Заметка

Заголовок shlwapi.h определяет StrNCat как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный, Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	shlwapi.h
библиотеки	Shlwapi.lib
DLL	Shlwapi.dll (версия 4.71 или более поздняя)

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