Funzione VarTokenizeFormatString (oleauto.h)

Articolo
03/08/2023

Analizza la stringa di formato effettivo in una serie di token che possono essere usati per formattare varianti usando VarFormatFromTokens.

Sintassi

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
);

Parametri

[in, optional] pstrFormat

Stringa di formato. Ad esempio"mm-dd-yy".

[in, out] rgbTok

Buffer del token di destinazione.

[in] cbTok

Dimensioni del buffer del token di destinazione.

[in] iFirstDay

Primo giorno della settimana.

Valore	Significato
0	Impostazione predefinita del sistema
1	Monday
2	Tuesday
3	Wednesday
4	Thursday
5	Friday
6	Sabato
7	Sunday

[in] iFirstWeek

Prima settimana dell'anno.

Valore	Significato
0	Impostazione predefinita del sistema.
1	La prima settimana contiene il 1° gennaio.
2	La metà più grande (quattro giorni) della prima settimana è nell'anno corrente.
3	La prima settimana ha sette giorni.

[in] lcid

Impostazioni locali in cui interpretare la stringa di formato.

[in, optional] pcbActual

Punta all'intero impostato sul primo token generato. Questo parametro può essere NULL.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_INVALIDARG	Uno o più argomenti non sono validi.
DISP_E_BUFFERTOOSMALL	Il buffer del token di destinazione è troppo piccolo.

Commenti

L'analisi della stringa di formato una volta e quindi l'uso ripetuto è in genere più veloce rispetto alla chiamata ripetuta di VarFormat, perché la seconda routine chiama VarTokenizeFormatString per ogni chiamata.

Le impostazioni locali passate controllano il modo in cui la stringa di formato viene interpretata, non il modo in cui viene visualizzato l'output effettivo di VarFormatFromTokens .

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	oleauto.h
Libreria	OleAut32.lib
DLL	OleAut32.dll

Condividi tramite