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

格式字符串。 例如“mm-dd-yy”。

[in] iFirstDay

一周的第一天。

值	含义
0	系统默认值
1	星期一
2	星期二
3	星期三
4	星期四
5	星期五
6	星期六
7	星期日

[in] iFirstWeek

一年的第一周。

值	含义
0	系统默认值。
1	第一周包含 1 月 1 日。
2	第一周) 四天 (大半是当年。
3	第一周有七天。

[in] dwFlags

控制格式设置过程的标志。 唯一可以设置的标志是VAR_CALENDAR_HIJRI或VAR_FORMAT_NOSUBSTITUTE。

[out] pbstrOut

表示变体的带格式字符串。

返回值

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

返回代码	说明
S_OK	成功。
E_INVALIDARG	一个或多个参数无效。

注解

此函数在调用 VarTokenizeFormatString 和 VarFormatFromTokens 时使用用户的默认区域设置。

要求

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

另请参阅

格式化例程

VarFormatFromTokens

VarTokenizeFormatString