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 月 1 日。
2
 第一周) 四天 (大半是当年。
3
 第一周有七天。

[in] lcid

要解释格式字符串的区域设置。

[in, optional] pcbActual

指向设置为第一个生成的标记的整数。 此参数可以为 NULL。

返回值

此函数可以返回其中一个值。

返回代码 说明
S_OK
 成功。
E_INVALIDARG
 一个或多个参数无效。
DISP_E_BUFFERTOOSMALL
目标令牌缓冲区太小。

注解

分析格式字符串一次，然后重复使用它通常比重复调用 VarFormat 要快，因为后者每次调用都会调用 VarTokenizeFormatString 。

传入的区域设置控制格式字符串的解释方式，而不是 VarFormatFromTokens 的实际输出的外观。

要求

要求 值
目标平台 Windows
标头 oleauto.h
Library OleAut32.lib
DLL OleAut32.dll