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


Функция VarFormat (oleauto.h)

Форматирует вариант в строковую форму путем синтаксического анализа строки формата.

Синтаксис

HRESULT VarFormat(
  [in]           LPVARIANT pvarIn,
  [in, optional] LPOLESTR  pstrFormat,
  [in]           int       iFirstDay,
  [in]           int       iFirstWeek,
  [in]           ULONG     dwFlags,
  [out]          BSTR      *pbstrOut
);

Параметры

[in] pvarIn

Вариант.

[in, optional] pstrFormat

Строка формата. Например, "мм-дд-гг".

[in] iFirstDay

Первый день недели.

Значение Значение
0
Системное значение по умолчанию
1
Понедельник
2
Вторник
3
Среда
4
Четверг
5
Пятница
6
Суббота
7
Воскресенье

[in] iFirstWeek

Первая неделя года.

Значение Значение
0
Системное значение по умолчанию.
1
Первая неделя содержит 1 января.
2
Большая половина (четыре дня) первой недели находится в текущем году.
3
Первая неделя имеет семь дней.

[in] dwFlags

Флаги, управляющие процессом форматирования. Можно задать только флаги VAR_CALENDAR_HIJRI или VAR_FORMAT_NOSUBSTITUTE.

[out] pbstrOut

Отформатированная строка, представляющая вариант.

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

Эта функция может возвращать одно из этих значений.

Код возврата Описание
S_OK
Успешно.
E_INVALIDARG
Один или несколько аргументов недопустимы.

Комментарии

Эта функция использует языковой стандарт пользователя по умолчанию при вызове VarTokenizeFormatString и VarFormatFromTokens.

Требования

Требование Значение
Целевая платформа Windows
Header oleauto.h
Библиотека OleAut32.lib
DLL OleAut32.dll

См. также раздел

Подпрограммы форматирования

VarFormatFromTokens

VarTokenizeFormatString