GetDurationFormat 함수(winnls.h)

아티클
03/08/2023

시간 기간을 식별자로 지정된 로캘의 시간 문자열로 서식을 지정합니다.

참고 상호 운용성을 위해 Microsoft가 새 로캘에 대한 로캘 식별자 대신 로캘 이름을 사용하도록 마이그레이션하기 때문에 애플리케이션은 GetDurationFormatEx 함수를 GetDurationFormat 에 선호해야 합니다. Windows Vista 이상에서만 실행되는 모든 애플리케이션은 GetDurationFormatEx를 사용해야 합니다.

구문

int GetDurationFormat(
  [in]            LCID             Locale,
  [in]            DWORD            dwFlags,
  [in, optional]  const SYSTEMTIME *lpDuration,
  [in]            ULONGLONG        ullDuration,
  [in, optional]  LPCWSTR          lpFormat,
  [out, optional] LPWSTR           lpDurationStr,
  [in]            int              cchDuration
);

매개 변수

[in] Locale

이 함수가 기간을 포맷하는 로캘을 지정하는 로캘 식별자입니다. MAKELCID 매크로를 사용하여 로캘 식별자를 만들거나 다음 미리 정의된 값 중 하나를 사용할 수 있습니다.

Windows Vista 이상: 다음 사용자 지정 로캘 식별자도 지원됩니다.

[in] dwFlags

함수 옵션을 지정하는 플래그입니다. lpFormat이 NULL로 설정되지 않은 경우 이 매개 변수를 0으로 설정해야 합니다. lpFormat이 NULL로 설정된 경우 애플리케이션은 지정된 로캘에 대한 시스템 기본 기간 형식을 사용하여 문자열의 서식을 지정하는 LOCALE_NOUSEROVERRIDE 지정할 수 있습니다.

주의 LOCALE_NOUSEROVERRIDE 사용하는 것은 사용자 기본 설정을 사용하지 않도록 설정하기 때문에 권장되지 않습니다.

[in, optional] lpDuration

형식을 지정할 기간 정보를 포함하는 SYSTEMTIME 구조체에 대한 포인터입니다. 이 포인터가 NULL이면 함수는 이 매개 변수를 무시하고 ullDuration을 사용합니다.

[in] ullDuration

기간의 100나노초 간격 수를 나타내는 64비트 부호 없는 정수입니다. lpDuration과 ullDuration이 모두 있는 경우 lpDuration이 우선합니다. lpDuration이 NULL로 설정되고 ullDuration이 0으로 설정된 경우 기간은 0입니다.

[in, optional] lpFormat

형식 문자열에 대한 포인터입니다. 자세한 내용은 GetDurationFormatEx의 lpFormat 매개 변수를 참조하세요.

[out, optional] lpDurationStr

함수가 기간 문자열을 검색하는 버퍼에 대한 포인터입니다.

또는 cchDuration이 0으로 설정된 경우 이 매개 변수에 NULL이 포함될 수 있습니다. 이 경우 함수는 기간 문자열 버퍼에 필요한 크기를 반환합니다.

[in] cchDuration

lpDurationStr로 표시된 버퍼의 크기(문자)입니다.

또는 애플리케이션에서 이 매개 변수를 0으로 설정할 수 있습니다. 이 경우 함수는 lpDurationStr에서 NULL을 검색하고 기간 문자열 버퍼에 필요한 크기를 반환합니다.

반환 값

성공하면 lpDurationStr 로 표시된 버퍼에서 검색된 문자 수를 반환합니다. lpDurationStr이 NULL로 설정되고 cchDuration이 0으로 설정된 경우 함수는 null 종료 문자를 포함하여 기간 문자열 버퍼에 필요한 크기를 반환합니다. 예를 들어 버퍼에 10자를 쓰는 경우 함수는 종료 null 문자를 포함하도록 11을 반환합니다.

함수가 성공하지 못하면 0을 반환합니다. 확장 오류 정보를 가져오기 위해 애플리케이션은 GetLastError를 호출할 수 있으며, 다음 오류 코드 중 하나를 반환할 수 있습니다.

ERROR_INSUFFICIENT_BUFFER. 제공된 버퍼 크기가 충분히 크지 않거나 NULL로 잘못 설정되었습니다.
ERROR_INVALID_PARAMETER. 매개 변수 값이 잘못되었습니다.

설명

GetDurationFormatEx에 대한 설명을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winnls.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll