Compartir a través de

Función WinHttpTimeToSystemTime (winhttp.h)

  • Artículo

La función WinHttpTimeToSystemTime toma una cadena de fecha y hora HTTP y la convierte en una estructura SYSTEMTIME .

Sintaxis

WINHTTPAPI BOOL WinHttpTimeToSystemTime(
  [in]  LPCWSTR    pwszTime,
  [out] SYSTEMTIME *pst
);

Parámetros

[in] pwszTime

Puntero a una cadena de fecha y hora terminada en null que se va a convertir. Este valor debe usar el formato definido en la sección 3.3 del RFC2616.

[out] pst

Puntero a la estructura SYSTEMTIME que recibe la hora convertida.

Valor devuelto

Devuelve TRUE si se ejecuta correctamente o FALSE de lo contrario. Para obtener información de error extendida, llame a GetLastError. Entre los códigos de error devueltos se encuentra:

Código de error Descripción
ERROR_WINHTTP_INTERNAL_ERROR
 Se ha producido un error interno.

Comentarios

Incluso cuando WinHTTP se usa en modo asincrónico (es decir, cuando WINHTTP_FLAG_ASYNC se ha establecido en WinHttpOpen), esta función funciona de forma sincrónica. El valor devuelto indica éxito o error. Para obtener información de error extendida, llame a GetLastError.

Nota Para Windows XP y Windows 2000, consulta la sección Requisitos en tiempo de ejecución de la página de inicio de WinHttp.
 

Ejemplos

En este ejemplo se muestra cómo convertir una fecha con formato HTTP a una estructura 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);
    }

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP, Windows 2000 Professional con SP3 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003, Windows 2000 Server con SP3 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winhttp.h
Library Winhttp.lib
Archivo DLL Winhttp.dll
Redistribuible WinHTTP 5.0 e Internet Explorer 5.01 o posterior en Windows XP y Windows 2000.

Consulte también

Acerca de los servicios HTTP de Microsoft Windows (WinHTTP)

Versiones winHTTP

WinHttpTimeFromSystemTime