Share via

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
 Tuesday
3
 星期三
4
 Thursday
5
 星期五
6
 星期六
7
 Sunday

[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
程式庫 OleAut32.lib
Dll OleAut32.dll

另請參閱

格式化例程

VarFormatFromTokens

VarTokenizeFormatString