Функция 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 или более поздняя)