WinHttpRequest (objeto)

En este tema se proporciona información sobre el uso del objeto COM WinHTTP WinHttpRequest con lenguajes de scripting. Para obtener más información, incluida la API de C++ ( WinHTTP), consulte Acerca de WinHTTP. Consulte Elección de una interfaz WinHTTP para obtener una comparación de estas interfaces.

Ejemplo

// Instantiate a WinHttpRequest object.
var WinHttpReq = new ActiveXObject("WinHttp.WinHttpRequest.5.1");
 IWinHttpRequest *  pIWinHttpRequest = NULL;
 \\..
    hr = CLSIDFromProgID(L"WinHttp.WinHttpRequest.5.1", &clsid);

    if (SUCCEEDED(hr))
    {
        hr = CoCreateInstance(clsid, NULL,
                              CLSCTX_INPROC_SERVER,
                              IID_IWinHttpRequest,
                              (void **)&pIWinHttpRequest);
    }

Ejemplos de código tomados de la propiedad IWinHttpRequest::Status.

Miembros

El objeto WinHttpRequest tiene estos tipos de miembros:

Eventos

El objeto WinHttpRequest tiene estos eventos.

Evento Descripción
OnError Se produce cuando se produce un error en tiempo de ejecución en la aplicación.
OnResponseDataAvailable Se produce cuando los datos están disponibles en la respuesta.
OnResponseFinished Se produce cuando se completan los datos de respuesta.
OnResponseStart Se produce cuando comienzan a recibirse los datos de respuesta.

Métodos

El objeto WinHttpRequest tiene estos métodos.

Método Descripción
Anulación Anula un método Send de WinHTTP.
GetAllResponseHeaders Recupera todos los encabezados de respuesta HTTP.
GetResponseHeader Recupera los encabezados de respuesta HTTP.
Abrir Abre una conexión HTTP a un recurso HTTP.
Envío Envía una solicitud HTTP a un servidor HTTP.
SetAutoLogonPolicy Establece la directiva de inicio de sesión automática actual.
SetClientCertificate Selecciona un certificado de cliente para enviar a un servidor de Protocolo seguro de transferencia de hipertexto (HTTPS).
SetCredentials Establece las credenciales que se usarán con un servidor HTTP, ya sea un origen o un servidor proxy.
SetProxy Establece la información del servidor proxy.
SetRequestHeader Agrega, cambia o elimina un encabezado de solicitud HTTP.
SetTimeouts Especifica, en milisegundos, los componentes de tiempo de espera individuales de una operación de envío y recepción.
WaitForResponse Especifica el tiempo de espera, en segundos, para que se complete un método Send asincrónico, con un valor de tiempo de espera opcional.

Propiedades

El objeto WinHttpRequest tiene estas propiedades.

Propiedad Tipo de acceso Descripción
Opción
Lectura/escritura
Establece o recupera un valor de opción WinHTTP.
ResponseBody
Solo lectura
Recupera el cuerpo de la entidad de respuesta como una matriz de bytes sin signo.
ResponseStream
Solo lectura
Recupera el cuerpo de la entidad de respuesta como IStream.
ResponseText
Solo lectura
Recupera el cuerpo de la entidad de respuesta como texto.
Estado
Solo lectura
Recupera el código de estado HTTP de la última respuesta.
Statustext
Solo lectura
Recupera el texto de estado HTTP.

Observaciones

El objeto WinHttpRequest usa la interfaz IErrorInfo para proporcionar datos de error. Se puede obtener una descripción y un valor numérico de error con el objeto Err en Microsoft Visual Basic Scripting Edition (VBScript) y el objeto Error en Microsoft JScript. Los 16 bits inferiores de un número de error corresponden a los valores encontrados en Mensajes de error.

Nota

Para Windows XP y Windows 2000, consulta Requisitos en tiempo de ejecución.

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]
Redistribuible
WinHTTP 5.0 e Internet Explorer 5.01 o posterior en Windows XP y Windows 2000.
IDL
HttpRequest.idl
Biblioteca
Winhttp.lib
Archivo DLL
Winhttp.dll

Vea también

Versiones de WinHTTP