Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 |
|