VarFormat-Funktion (oleauto.h)

  • Artikel

Formatiert eine Variante in Zeichenfolgenform, indem eine Formatzeichenfolge analysiert wird.

Syntax

HRESULT VarFormat(
  [in]           LPVARIANT pvarIn,
  [in, optional] LPOLESTR  pstrFormat,
  [in]           int       iFirstDay,
  [in]           int       iFirstWeek,
  [in]           ULONG     dwFlags,
  [out]          BSTR      *pbstrOut
);

Parameter

[in] pvarIn

Die Variante.

[in, optional] pstrFormat

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

[in] iFirstDay

Erster Wochentag.

Wert Bedeutung
0
 Die Standardeinstellung des Systems
1
 Montag
2
 Tuesday
3
 Wednesday
4
 Thursday
5
 Freitag
6
 Samstag
7
 Sonntag

[in] iFirstWeek

Erste Woche des Jahres.

Wert Bedeutung
0
 Der Standard des Systems.
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] dwFlags

Flags, die den Formatierungsprozess steuern. Die einzigen Flags, die festgelegt werden können, sind VAR_CALENDAR_HIJRI oder VAR_FORMAT_NOSUBSTITUTE.

[out] pbstrOut

Die formatierte Zeichenfolge, die die Variante darstellt.

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.

Hinweise

Diese Funktion verwendet beim Aufrufen von VarTokenizeFormatString und VarFormatFromTokens das Standardgebietsschema des Benutzers.

Anforderungen

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

Weitere Informationen

Formatierungsroutinen

VarFormatFromTokens

VarTokenizeFormatString