Функция wnsprintfW (shlwapi.h)
Принимает список аргументов переменной длины и возвращает значения аргументов в виде строки в формате printf.
Синтаксис
int wnsprintfW(
[out] PWSTR pszDest,
[in] int cchDest,
[in] PCWSTR pszFmt,
...
);
Параметры
[out] pszDest
Тип: PTSTR
Указатель на буфер, который при успешном возврате этой функции получает выходную строку.
[in] cchDest
Тип: int
Максимально допустимое количество символов в pszDest.
[in] pszFmt
Тип: PCTSTR
Строка формата в стиле printf. Идентификатор формата %s никогда не следует использовать в неограниченной форме. Чтобы избежать потенциального переполнения буфера, всегда указывайте размер; например "%32s".
...
Дополнительные параметры, содержащие выходные данные.
Возвращаемое значение
Тип: int
Возвращает число символов, записанных в буфер, за исключением завершающих символов NULL . При возникновении ошибки возвращается отрицательное значение.
Комментарии
Предупреждение системы безопасности: Неправильное использование этой функции может поставить под угрозу безопасность приложения. Скопированная строка не гарантирует, что она будет заканчиваться null. Рассмотрите возможность использования одного из следующих вариантов. StringCbPrintf, StringCbPrintfEx, StringCbVPrintf, StringCbVPrintfEx, StringCchPrintf, StringCchPrintfEx, StringCchVPrintf или StringCchVPrintfEx. Прежде чем продолжить, ознакомьтесь с рекомендациями по безопасности: Microsoft Windows Shell .
Это версия sprintf для Windows. Он не поддерживает типы с плавающей запятой или указателей. Поддерживается только флаг выравнивания по левому краю.
Примечание
Заголовок shlwapi.h определяет wnsprintf как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional, Windows XP [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | shlwapi.h |
Библиотека | Shlwapi.lib |
DLL | Shlwapi.dll (версия 5.0 или более поздняя) |