Funzione WinHttpTimeFromSystemTime (winhttp.h)
La funzione WinHttpTimeFromSystemTime formatta una data e un'ora in base alla specifica HTTP versione 1.0.
Sintassi
WINHTTPAPI BOOL WinHttpTimeFromSystemTime(
[in] const SYSTEMTIME *pst,
[out] LPWSTR pwszTime
);
Parametri
[in] pst
Puntatore a una struttura SYSTEMTIME che contiene la data e l'ora da formattare.
[out] pwszTime
Puntatore a un buffer stringa che riceve la data e l'ora formattate. Il buffer deve essere uguale alle dimensioni, in byte, di WINHTTP_TIME_FORMAT_BUFSIZE.
Valore restituito
Restituisce TRUE se l'operazione riesce o FALSE in caso contrario. Per informazioni dettagliate sull'errore, chiamare GetLastError. I codici di errore includono quanto segue.
Codice di errore | Descrizione |
---|---|
|
Si è verificato un errore interno. |
Commenti
Anche quando WinHTTP viene usato in modalità asincrona , ovvero quando WINHTTP_FLAG_ASYNC è stato impostato in WinHttpOpen, questa funzione funziona in modo sincrono. Il valore restituito indica l'esito positivo o negativo. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Esempio
Il codice di esempio di codice seguente illustra come convertire una struttura SYSTEMTIME in una stringa contenente l'ora in formato 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;
Requisiti
Client minimo supportato | Windows XP, Windows 2000 Professional con SP3 [solo app desktop] |
Server minimo supportato | Windows Server 2003, Windows 2000 Server con SP3 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | winhttp.h |
Libreria | Winhttp.lib |
DLL | Winhttp.dll |
Componente ridistribuibile | WinHTTP 5.0 e Internet Explorer 5.01 o versione successiva in Windows XP e Windows 2000. |
Vedi anche
Informazioni sui servizi HTTP di Microsoft Windows (WinHTTP)