共用方式為

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

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