WinHttpTimeFromSystemTime 함수(winhttp.h)
WinHttpTimeFromSystemTime 함수는 HTTP 버전 1.0 사양에 따라 날짜와 시간의 형식을 지정합니다.
구문
WINHTTPAPI BOOL WinHttpTimeFromSystemTime(
[in] const SYSTEMTIME *pst,
[out] LPWSTR pwszTime
);
매개 변수
[in] pst
서식을 지정할 날짜와 시간을 포함하는 SYSTEMTIME 구조체에 대한 포인터입니다.
[out] pwszTime
형식이 지정된 날짜 및 시간을 수신하는 문자열 버퍼에 대한 포인터입니다. 버퍼는 WINHTTP_TIME_FORMAT_BUFSIZE 크기(바이트)와 같아야 합니다.
반환 값
성공하면 TRUE를 반환하고 그렇지 않으면 FALSE를 반환합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다. 오류 코드에는 다음이 포함됩니다.
| 오류 코드 | Description |
|---|---|
|
내부 오류가 발생했습니다. |
설명
WinHTTP가 비동기 모드(즉, WinHttpOpen에서 WINHTTP_FLAG_ASYNC 설정된 경우)에서 사용되는 경우에도 이 함수는 동기적으로 작동합니다. 반환 값은 성공 또는 실패를 나타냅니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
참고 Windows XP 및 Windows 2000의 경우 WinHTTP 시작 페이지의 런타임 요구 사항 섹션을 참조하세요.
예제
다음 코드 예제 코드는 SYSTEMTIME 구조를 HTTP 형식의 시간을 포함하는 문자열로 변환하는 방법을 보여 줍니다.
SYSTEMTIME sTime;
LPWSTR pwszTimeStr;
// Get the current time.
GetSystemTime(&sTime);
// Allocate memory for the string.
// Note: WINHTTP_TIME_FORMAT_BUFSIZE is a byte count.
// Therefore, you must divide the array by
// sizeof WCHAR to get the proper string length.
pwszTimeStr = new WCHAR[WINHTTP_TIME_FORMAT_BUFSIZE/sizeof(WCHAR)];
// Convert the current time to HTTP format.
if(!WinHttpTimeFromSystemTime( &sTime, pwszTimeStr))
{
printf( "Error %u in WinHttpTimeFromSystemTime.\n", GetLastError());
}
else
{
// Print the time.
printf("Current time is (%S)\n", pwszTimeStr);
}
// Free the memory.
delete [] pwszTimeStr;
요구 사항
| 지원되는 최소 클라이언트 | Windows XP, Windows 2000 Professional SP3 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003, Windows 2000 Server SP3 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winhttp.h |
| 라이브러리 | Winhttp.lib |
| DLL | Winhttp.dll |
| 재배포 가능 파일 | Windows XP 및 Windows 2000에서 WinHTTP 5.0 및 인터넷 Explorer 5.01 이상. |