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

Статья
11/20/2024

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

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

Синтаксис

int wvnsprintfA(
  [out] PSTR    pszDest,
  [in]  int     cchDest,
  [in]  PCSTR   pszFmt,
  [in]  va_list arglist
);

Параметры

[out] pszDest

Тип: PTSTR

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

[in] cchDest

Тип: int

Максимальное число символов, разрешенных в pszDest.

[in] pszFmt

Тип: PCTSTR

Строка формата форматаprintf. Идентификатор формата %s никогда не должен использоваться в необвязанной форме. Чтобы избежать возможных переполнений буфера, всегда укажите размер; например, "%32s".

[in] arglist

Тип: va_list

Указатель на список параметров командной строки, используемых для настройки выходных данных.

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

Тип: int

Возвращает количество символов, записанных в буфер, за исключением всех конечных символов NULL. Отрицательное значение возвращается при возникновении ошибки.

Замечания

предупреждение системы безопасности: использование этой функции неправильно может скомпрометируйте безопасность приложения. Скопированная строка не гарантируется, что она завершается null. Рассмотрите возможность использования одного из следующих вариантов. StringCbPrintf, StringCbPrintfEx, StringCbVPrintf, StringCbVPrintfEx, StringCchPrintf, StringCchPrintfEx, StringCchVPrintfили StringCchVPrintfEx. Перед продолжением следует просмотреть вопросы безопасности: microsoft Windows Shell.

Заметка

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

Требования

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

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