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