VarTokenizeFormatString 함수(oleauto.h)

실제 서식 문자열을 VarFormatFromTokens를 사용하여 변형의 서식을 지정하는 데 사용할 수 있는 일련의 토큰으로 구문 분석합니다.

구문

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

매개 변수

[in, optional] pstrFormat

서식 문자열입니다. 예: "mm-dd-yyy".

[in, out] rgbTok

대상 토큰 버퍼입니다.

[in] cbTok

대상 토큰 버퍼의 크기입니다.

[in] iFirstDay

요일의 첫 날입니다.

값	의미
0	시스템 기본
1	월요일
2	화요일
3	수요일
4	목요일
5	금요일
6	토요일
7	일요일

[in] iFirstWeek

올해의 첫 번째 주.

값	의미
0	시스템 기본값입니다.
1	첫 주에는 1월 1일이 포함됩니다.
2	첫 주의 절반(4일)이 현재 연도에 있습니다.
3	첫 주에는 7일이 있습니다.

[in] lcid

형식 문자열을 해석할 로캘입니다.

[in, optional] pcbActual

처음 생성된 토큰으로 설정된 정수 를 가리킵니다. 이 매개 변수는 NULL일 수 있습니다.

반환 값

이 함수는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	성공.
E_INVALIDARG	하나 이상의 인수가 잘못되었습니다.
DISP_E_BUFFERTOOSMALL	대상 토큰 버퍼가 너무 작습니다.

설명

형식 문자열을 한 번 구문 분석한 다음 반복적으로 사용하는 것은 일반적으로 VarFormat 을 반복적으로 호출하는 것보다 빠릅니다. 후자의 루틴은 각 호출에 대해 VarTokenizeFormatString을 호출하기 때문입니다.

전달되는 로캘은 VarFormatFromTokens 의 실제 출력이 아닌 형식 문자열이 해석되는 방식을 제어합니다.

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	oleauto.h
라이브러리	OleAut32.lib
DLL	OleAut32.dll