WinHttpTimeFromSystemTime-Funktion (winhttp.h)
Die WinHttpTimeFromSystemTime-Funktion formatiert ein Datum und eine Uhrzeit gemäß der HTTP-Version 1.0-Spezifikation.
Syntax
WINHTTPAPI BOOL WinHttpTimeFromSystemTime(
[in] const SYSTEMTIME *pst,
[out] LPWSTR pwszTime
);
Parameter
[in] pst
Ein Zeiger auf eine SYSTEMTIME-Struktur , die das zu formatierende Datum und die Uhrzeit enthält.
[out] pwszTime
Ein Zeiger auf einen Zeichenfolgenpuffer, der das formatierte Datum und die formatierte Uhrzeit empfängt. Der Puffer sollte der Größe von WINHTTP_TIME_FORMAT_BUFSIZE in Bytes entsprechen.
Rückgabewert
Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder andernfalls FALSE . Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Zu den Fehlercodes zählen die folgenden.
| Fehlercode | BESCHREIBUNG |
|---|---|
|
Ein interner Fehler ist aufgetreten. |
Hinweise
Auch wenn WinHTTP im asynchronen Modus verwendet wird (d. h. wenn WINHTTP_FLAG_ASYNC in WinHttpOpen festgelegt wurde), arbeitet diese Funktion synchron. Der Rückgabewert weist auf Erfolg oder Fehler hin. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Beispiele
Der folgende Codebeispielcode zeigt, wie eine SYSTEMTIME-Struktur in eine Zeichenfolge konvertiert wird, die die Zeit im HTTP-Format enthält.
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;
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP, Windows 2000 Professional mit SP3 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003, Windows 2000 Server mit SP3 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winhttp.h |
| Bibliothek | Winhttp.lib |
| DLL | Winhttp.dll |
| Verteilbare Komponente | WinHTTP 5.0 und Internet Explorer 5.01 oder höher unter Windows XP und Windows 2000. |