[GetTimeFormatWrapW 는 Windows XP에서 사용할 수 있습니다. 후속 버전에서는 사용할 수 없습니다. GetTimeFormatW를 대신 사용해야 합니다.]
지정된 로캘에 대한 시간 문자열로 시간 형식을 지정합니다. 함수는 지정된 시간 또는 로컬 시스템 시간의 형식을 지정합니다.
참고
GetTimeFormatWrapW 는 GetTimeFormatW 함수에 대한 래퍼입니다. 추가 사용량 정보는 GetTimeFormat 페이지를 참조하세요.
구문
int GetTimeFormatWrapW(
_In_ LCID Locale,
_In_ DWORD dwFlags,
_In_ const SYSTEMTIME *lpTime,
_In_ LPCWSTR pwzFormat,
_Out_ LPWSTR pwzTimeStr,
_In_ int cchTime
);
매개 변수
-
로캘 [in]
-
형식: LCID
시간 문자열의 서식을 지정할 로캘을 지정합니다. pwzFormat이 NULL인 경우 함수는 이 로캘의 시간 형식에 따라 문자열의 형식을 지정합니다. pwzFormat이 NULL이 아닌 경우 함수는 그림 문자열 형식에 지정되지 않은 정보(예: 로캘의 시간 표식)에만 로캘을 사용합니다.
이 매개 변수는 MAKELCID 매크로에서 만든 로캘 식별자이거나 다음과 같은 미리 정의된 값 중 하나일 수 있습니다.
-
LOCALE_SYSTEM_DEFAULT
-
기본 시스템 로캘입니다.
-
LOCALE_USER_DEFAULT
-
기본 사용자 로캘입니다.
dwFlags [in]
형식:DWORD
다양한 함수 옵션을 지정합니다. 다음 값의 조합을 지정할 수 있습니다.
LOCALE_NOUSEROVERRIDE
설정된 경우 함수는 지정된 로캘에 대한 시스템 기본 시간 형식을 사용하여 문자열의 형식을 지정합니다. 설정하지 않으면 함수는 모든 사용자 재정의를 사용하여 문자열의 형식을 로캘의 기본 시간 형식으로 지정합니다. pwzFormat이 NULL인 경우에만 이 플래그를 설정할 수 있습니다.
LOCALE_USE_CP_ACP
로캘 코드 페이지 대신 문자열 변환에 시스템 ANSI 코드 페이지를 사용합니다.
TIME_NOMINUTESORSECONDS
분 또는 초를 사용하지 않습니다.
TIME_NOSECONDS
초를 사용하지 않습니다.
TIME_NOTIMEMARKER
시간 표식을 사용하지 않습니다.
TIME_FORCE24HOURFORMAT
항상 24시간 형식을 사용합니다.
lpTime [in]
형식: const SYSTEMTIME*
서식을 지정할 시간 정보가 포함된 SYSTEMTIME 구조체에 대한 포인터입니다. 이 포인터가 NULL이면 함수는 현재 로컬 시스템 시간을 사용합니다.
pwzFormat [in]
형식: LPCWSTR
시간 문자열을 형성하는 데 사용할 형식에 대한 포인터입니다. pwzFormat이 NULL인 경우 함수는 지정된 로캘의 시간 형식을 사용합니다. 자세한 내용은 GetTimeFormat 을 참조하세요.
pwzTimeStr [out]
형식: LPWSTR
형식이 지정된 시간 문자열을 수신하는 버퍼에 대한 포인터입니다.
cchTime [in]
형식: int
pwzTimeStr 버퍼의 크기(문자)입니다. cchTime이 0이면 함수는 형식이 지정된 시간 문자열을 보유하는 데 필요한 문자 수를 반환하며 pwzTimeStr에서 가리키는 버퍼는 사용되지 않습니다.
반환 값
형식: int
함수가 성공하면 반환 값은 pwzTimeStr이 가리키는 버퍼에 기록된 문자 수입니다. cchTime 매개 변수가 0이면 반환 값은 형식이 지정된 시간 문자열을 보유하는 데 필요한 문자 수입니다. 개수에는 종료 null 문자가 포함됩니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다. GetLastError 는 다음 오류 코드 중 하나를 반환할 수 있습니다.
-
ERROR_INSUFFICIENT_BUFFER
-
ERROR_INVALID_FLAGS
-
ERROR_INVALID_PARAMETER
설명
GetTimeFormatWrapW 는 Windows XP 이전 운영 체제에서 유니코드 문자열을 사용하는 기능을 제공합니다. 기본 방법은 MsLU(Microsoft Layer for Unicode)와 함께 GetTimeFormatW 를 사용하는 것입니다.
GetTimeFormatWrapW 는 서수 310을 사용하여 Shlwapi.dll 직접 호출해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 2000 Professional, Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| DLL |
|
추가 정보