WinHttpTimeToSystemTime 함수(winhttp.h)
WinHttpTimeToSystemTime 함수는 HTTP 시간/날짜 문자열을 사용하여 SYSTEMTIME 구조체로 변환합니다.
구문
WINHTTPAPI BOOL WinHttpTimeToSystemTime(
[in] LPCWSTR pwszTime,
[out] SYSTEMTIME *pst
);
매개 변수
[in] pwszTime
변환할 null 종료 날짜/시간 문자열에 대한 포인터입니다. 이 값은 RFC2616 섹션 3.3에 정의된 형식을 사용해야 합니다.
[out] pst
변환된 시간을 수신하는 SYSTEMTIME 구조체에 대한 포인터입니다.
반환 값
성공하면 TRUE를 반환하고 그렇지 않으면 FALSE를 반환합니다. 확장된 오류 정보는 GetLastError를 호출합니다. 반환된 오류 코드 중 은 다음과 같습니다.
| 오류 코드 | Description |
|---|---|
|
내부 오류가 발생했습니다. |
설명
WinHTTP가 비동기 모드(즉, WinHttpOpen에서 WINHTTP_FLAG_ASYNC 설정된 경우)에서 사용되는 경우에도 이 함수는 동기적으로 작동합니다. 반환 값은 성공 또는 실패를 나타냅니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
참고 Windows XP 및 Windows 2000의 경우 WinHttp 시작 페이지의 런타임 요구 사항 섹션을 참조하세요.
예제
이 예제에서는 HTTP 형식이 지정된 날짜를 SYSTEMTIME 구조체로 변환하는 방법을 보여줍니다.
SYSTEMTIME sTime;
LPCWSTR pwszTimeStr = L"Tue, 21 Nov 2000 01:06:53 GMT";
// Convert the HTTP string to a SYSTEMTIME structure.
if (!WinHttpTimeToSystemTime( pwszTimeStr, &sTime))
{
printf( "Error %u in WinHttpTimeToSystemTime.\n", GetLastError());
}
else
{
// Print the date.
printf( "The U.S. formatted date is (%u/%u/%u)\n",
sTime.wMonth, sTime.wDay, sTime.wYear);
}
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 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 이상. |