функция wnsprintfA (shlwapi.h)

Статья
11/20/2024

Принимает список аргументов переменной длины и возвращает значения аргументов в виде строки printf-style.

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

Синтаксис

int wnsprintfA(
  [out] PSTR  pszDest,
  [in]  int   cchDest,
  [in]  PCSTR 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.

Это версия спринтфаWindows. Он не поддерживает типы с плавающей запятой или указателем. Он поддерживает только флаг выравнивания слева.

Заметка

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

Требования

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

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