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 を呼び出します。 返されるエラー コードは次のとおりです。
| エラー コード | 説明 |
|---|---|
|
内部エラーが発生しました。 |
注釈
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 |
| Library | Winhttp.lib |
| [DLL] | Winhttp.dll |
| 再頒布可能パッケージ | Windows XP および Windows 2000 では、WinHTTP 5.0 およびインターネット エクスプローラー 5.01 以降がインストールされています。 |