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

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

  • Статья

Анализирует фактическую строку формата в последовательность маркеров, которые можно использовать для форматирования вариантов с помощью VarFormatFromTokens.

Синтаксис

HRESULT VarTokenizeFormatString(
  [in, optional] LPOLESTR pstrFormat,
  [in, out]      LPBYTE   rgbTok,
  [in]           int      cbTok,
  [in]           int      iFirstDay,
  [in]           int      iFirstWeek,
  [in]           LCID     lcid,
  [in, optional] int      *pcbActual
);

Параметры

[in, optional] pstrFormat

Строка формата. Например, "mm-dd-yy".

[in, out] rgbTok

Буфер маркеров назначения.

[in] cbTok

Размер буфера маркеров назначения.

[in] iFirstDay

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

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

[in] iFirstWeek

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

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

[in] lcid

Языковой стандарт, в который интерпретируется строка формата.

[in, optional] pcbActual

Указывает на целое число, для которого задается первый созданный токен. Этот параметр может принимать значение NULL.

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

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

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

Комментарии

Синтаксический анализ строки формата один раз и ее многократное использование обычно выполняется быстрее, чем повторный вызов VarFormat , так как последняя подпрограмма вызывает VarTokenizeFormatString для каждого вызова.

Языковой стандарт, который вы передаете, управляет интерпретацией строки формата, а не фактическими выходными данными VarFormatFromTokens .

Требования

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