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 |
|
| Biblioteca |
|
| Archivo DLL |
|