VarFormat-Funktion (oleauto.h)

Artikel
08/25/2023

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

Freigeben über