Parses the actual format string into a series of tokens which can be used to format variants using VarFormatFromTokens.
[in] Points to the format string for example "mm-dd-yy".
[in, out] Points to the destination token buffer.
[in] Size of the destination token buffer.
[in] First day of the week, 0 = system default, 1 = Monday, 2 = Tuesday etc.
[in] First week of the year. The following table describes the values for iFirstWeek:
The system default
The first week contains January 1st.
The larger half (four days) of the first week is in the current year.
The first week has seven days.
[in] Locale to interpret format string in.
[out] Points to the integer which is set to the first generated token. Can be NULL.
The function returns one of the following:
One or more of the arguments is invalid.
The destination token buffer is too small.
Parsing the format string once and then using it repeatedly is usually faster than calling VarFormat repeatedly since the latter routines calls VarTokenizeFormatString for each call.
The locale you pass in controls how the format string is interpreted, not how the actual output of VarFormatFromTokens will look.