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

Копирует одну строку в другую.

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

 

Синтаксис

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

Параметры

[out] psz1

Тип: PTSTR

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

[in] psz2

Тип: PCTSTR

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

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

Тип: PTSTR

Возвращает указатель на psz1.

Комментарии

Предупреждение системы безопасности: Неправильное использование этой функции может поставить под угрозу безопасность приложения. Первый аргумент , psz1, должен быть достаточно большим, чтобы вместить psz2 и закрывающий "\0", в противном случае может произойти переполнение буфера. Переполнение буфера может привести к атаке типа "отказ в обслуживании" на приложение в случае нарушения доступа. В худшем случае переполнение буфера может позволить злоумышленнику внедрить исполняемый код в процесс, особенно если psz1 является буфером на основе стека. Рассмотрите возможность использования одного из следующих вариантов: StringCbCopy, StringCbCopyEx, StringCbCopyN, StringCbCopyN,StringCchCopy, StringCchCopyEx, StringCchCopyN или StringCchCopyNEx. Прежде чем продолжить, ознакомьтесь с рекомендациями по безопасности: Microsoft Windows Shell .

Требования

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