Interfaz IWinHttpRequest

La interfaz IWinHttpRequest proporciona todos los métodos que no son de evento para los Servicios HTTP de Microsoft Windows (WinHTTP).

Miembros

La interfaz IWinHttpRequest hereda de la interfaz IUnknown . IWinHttpRequest también tiene estos tipos de miembros:

Métodos

La interfaz IWinHttpRequest 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 servidor proxy o un servidor de origen.
SetProxy Establece la información del servidor proxy.
SetRequestHeader Agrega, cambia o elimina un encabezado de solicitud HTTP.
SetTimeouts Especifica los componentes de tiempo de espera individuales de una operación de envío y recepción, en milisegundos.
WaitForResponse Espera a que se complete un método Send asincrónico, con un valor de tiempo de espera opcional, en segundos.

Propiedades

La interfaz IWinHttpRequest tiene estas propiedades.

Propiedad Tipo de acceso Descripción
Opción
Lectura/escritura
Valor de la opción WinHTTP.
ResponseBody
Solo lectura
Cuerpo de la entidad de respuesta como una matriz de bytes sin signo.
ResponseStream
Solo lectura
Cuerpo de la entidad de respuesta como IStream.
ResponseText
Solo lectura
Cuerpo de la entidad de respuesta.
Estado
Solo lectura
Código de estado HTTP de la última respuesta.
Statustext
Solo lectura
Texto de estado HTTP.

Observaciones

La interfaz IWinHttpRequest definida en httprequest.idl se implementa mediante una clase con el identificador de CLSID_WinHttpRequest. Una aplicación obtiene esta interfaz llamando a CoCreateInstance con un identificador de clase de CLSID_WinHttpRequest y un identificador de interfaz de IID_IWinHttpRequest.

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.

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

Consulte también

IWinHttpRequestEvents

Versiones de WinHTTP