VarTokenizeFormatString
Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]
Analysiert die aktuelle Formatzeichenfolge in eine Reihe von Token, die zum Formatieren von Varianten mit VarFormatFromTokens verwendet werden kann.
LPBYTE VarTokenizeFormatString(
LPOLESTR pstrFormat,
LPBYTE rgbTok,
int cbTok,
int iFirstDay,
int iFirstWeek,
LCID lcid,
int *pcbActual
);
Parameter
pstrFormat
[in] Verweist auf die Formatzeichenfolge beispielsweise "mm-tt-jj".rgbTok
[in, out] In den Zielpuffer token verweist.cbTok
[in] Größe des Zielpuffers token.iFirstDay
[in] Erster Tag der Woche, 0 = Systemstandard, 1 = Montag, 2 = Dienstag usw..iFirstWeek
[in] Erste Woche des Jahres. In der folgende Tabelle werden die Werte für iFirstWeek beschrieben:iFirstWeek Werte
Bedeutung
0
Die Standardeinstellung des Systems
1
Die erste Woche enthält 1. Januar.
2
Die größeren Hälfte (vier Tage) die erste Woche im aktuellen Jahr ist.
3
Die erste Woche hat sieben Tage.
lcid
[in] Gebietsschema Formatzeichenfolge in zu interpretieren sind.pcbActual
[Out] Verweist auf die Ganzzahl, die auf das erste generierte Token festgelegt ist. NULL kann sein.
Rückgabewert
Die Funktion gibt eine der folgenden zurück:
Rückgabewert |
Bedeutung |
---|---|
S_OK |
Erfolg. |
E_INVALIDARG |
Eine oder mehrere der Argumente ist ungültig. |
DISP_E_BUFFERTOOSMALL |
Der Ziel-token-Puffer ist zu klein. |
Hinweise
Die Formatzeichenfolge einmal analysieren und dann wiederholt mit ist normalerweise schneller als aufrufende VarFormat wiederholt, da letzteren Routinen VarTokenizeFormatString für jeden Aufruf aufruft.
Das Gebietsschema, das Sie Steuerelemente übergeben, wie die Formatzeichenfolge interpretiert wird, sieht nicht wie die aktuelle Ausgabe der VarFormatFromTokens.