VarTokenizeFormatString-Funktion (oleauto.h)

Artikel
08/25/2023

Analysiert die tatsächliche Formatzeichenfolge in eine Reihe von Token, die zum Formatieren von Varianten mithilfe von VarFormatFromTokens verwendet werden können.

Syntax

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
);

Parameter

[in, optional] pstrFormat

Die Formatzeichenfolge. Beispiel: "mm-tt-yy".

[in, out] rgbTok

Der Zieltokenpuffer.

[in] cbTok

Die Größe des Zieltokenpuffers.

[in] iFirstDay

Erster Wochentag.

Wert	Bedeutung
0	Der Systemstandard
1	Montag
2	Tuesday
3	Wednesday
4	Thursday
5	Freitag
6	Samstag
7	Sonntag

[in] iFirstWeek

Erste Woche des Jahres.

Wert	Bedeutung
0	Der Systemstandard.
1	Die erste Woche enthält den 1. Januar.
2	Die größere Hälfte (vier Tage) der ersten Woche liegt im aktuellen Jahr.
3	Die erste Woche hat sieben Tage.

[in] lcid

Das Gebietsschema, in dem die Formatzeichenfolge interpretiert werden soll.

[in, optional] pcbActual

Zeigt auf die ganze Zahl, die auf das erste generierte Token festgelegt ist. Dieser Parameter kann NULL sein.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_INVALIDARG	Mindestens eines der Argumente ist ungültig.
DISP_E_BUFFERTOOSMALL	Der Zieltokenpuffer ist zu klein.

Hinweise

Das einmale Analysieren der Formatzeichenfolge und die wiederholte Verwendung ist in der Regel schneller als das wiederholte Aufrufen von VarFormat , da bei letzterer Routine VarTokenizeFormatString für jeden Aufruf aufgerufen wird.

Das Gebietsschema, das Sie übergeben, steuert, wie die Formatzeichenfolge interpretiert wird, nicht wie die tatsächliche Ausgabe von VarFormatFromTokens aussieht.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	oleauto.h
Bibliothek	OleAut32.lib
DLL	OleAut32.dll

Freigeben über