VarTokenizeFormatString-Funktion (oleauto.h)

  • Artikel

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