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

Копирует указанное число символов из начала одной строки в другую.

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

 

Синтаксис

PWSTR StrCpyNW(
  [out] PWSTR  pszDst,
  [in]  PCWSTR pszSrc,
        int    cchMax
);

Параметры

[out] pszDst

Тип: PTSTR

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

[in] pszSrc

Тип: PCTSTR

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

cchMax

Тип: int

Число копируемых символов, включая завершающий пустой символ.

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

Тип: PTSTR

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

Комментарии

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

Требования

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