Compartir a través de

Función WinHttpTimeFromSystemTime (winhttp.h)

  • Artículo

La función WinHttpTimeFromSystemTime da formato a una fecha y hora según la especificación http versión 1.0.

Sintaxis

WINHTTPAPI BOOL WinHttpTimeFromSystemTime(
  [in]  const SYSTEMTIME *pst,
  [out] LPWSTR           pwszTime
);

Parámetros

[in] pst

Puntero a una estructura SYSTEMTIME que contiene la fecha y hora a las que se va a dar formato.

[out] pwszTime

Puntero a un búfer de cadena que recibe la fecha y hora con formato. El búfer debe ser igual al tamaño, en bytes, de WINHTTP_TIME_FORMAT_BUFSIZE.

Valor devuelto

Devuelve TRUE si es correcto o FALSE en caso contrario. Para obtener información de error extendida, llame a GetLastError. Los códigos de error incluyen lo siguiente.

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 se ha establecido WINHTTP_FLAG_ASYNC 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

El código de ejemplo de código siguiente muestra cómo convertir una estructura SYSTEMTIME en una cadena que contiene la hora en 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;

Requisitos

   
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 de WinHTTP

WinHttpTimeToSystemTime