Partager via


Fonction VarFormat (oleauto.h)

Met en forme une variante sous forme de chaîne en analysant une chaîne de format.

Syntaxe

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

Paramètres

[in] pvarIn

Variante.

[in, optional] pstrFormat

Chaîne de format. Par exemple , « mm-dd-yy ».

[in] iFirstDay

Premier jour de la semaine.

Valeur Signification
0
Valeur par défaut du système
1
Lundi
2
Mardi
3
Mercredi
4
Jeudi
5
Vendredi
6
Samedi
7
Dimanche

[in] iFirstWeek

Première semaine de l’année.

Valeur Signification
0
Valeur par défaut du système.
1
La première semaine contient le 1er janvier.
2
La plus grande moitié (quatre jours) de la première semaine se situe dans l’année en cours.
3
La première semaine a sept jours.

[in] dwFlags

Indicateurs qui contrôlent le processus de mise en forme. Les seuls indicateurs qui peuvent être définis sont VAR_CALENDAR_HIJRI ou VAR_FORMAT_NOSUBSTITUTE.

[out] pbstrOut

Chaîne mise en forme qui représente la variante.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
Réussite.
E_INVALIDARG
Un ou plusieurs arguments ne sont pas valides.

Remarques

Cette fonction utilise les paramètres régionaux par défaut de l’utilisateur lors de l’appel de VarTokenizeFormatString et VarFormatFromTokens.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête oleauto.h
Bibliothèque OleAut32.lib
DLL OleAut32.dll

Voir aussi

Routines de mise en forme

VarFormatFromTokens

VarTokenizeFormatString