Oggetto WinHttpRequest

Articolo
06/13/2023

Questo argomento fornisce informazioni sull'uso dell'oggetto COM WinHTTP WinHttpRequest con i linguaggi di scripting. Per altre informazioni, inclusa l'API C++ (WinHTTP), vedere Informazioni su WinHTTP. Per un confronto di queste interfacce, vedere Scelta di un'interfaccia WinHTTP .

Esempio

// 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);
    }

Esempi di codice tratti dalla proprietà IWinHttpRequest::Status.

Membri

L'oggetto WinHttpRequest ha questi tipi di membri:

Eventi
Metodi
Proprietà

Eventi

L'oggetto WinHttpRequest include questi eventi.

Event	Descrizione
OnError	Si verifica quando si verifica un errore di runtime nell'applicazione.
OnResponseDataAvailable	Si verifica quando i dati sono disponibili dalla risposta.
OnResponseFinished	Si verifica al completamento dei dati di risposta.
OnResponseStart	Si verifica quando i dati della risposta iniziano a essere ricevuti.

Metodi

L'oggetto WinHttpRequest include questi metodi.

Metodo	Descrizione
Interrompere	Interrompe un metodo WinHTTP Send .
GetAllResponseHeaders	Recupera tutte le intestazioni di risposta HTTP.
GetResponseHeader	Recupera le intestazioni di risposta HTTP.
Open	Apre una connessione HTTP a una risorsa HTTP.
Invia	Invia una richiesta HTTP a un server HTTP.
SetAutoLogonPolicy	Imposta il criterio di accesso automatico corrente.
SetClientCertificate	Seleziona un certificato client da inviare a un server HTTPS (Secure Hypertext Transfer Protocol).
SetCredentials	Imposta le credenziali da utilizzare con un server HTTP, ovvero un'origine o un server proxy.
SetProxy	Imposta le informazioni sul server proxy.
SetRequestHeader	Aggiunge, modifica o elimina un'intestazione di richiesta HTTP.
SetTimeouts	Specifica, in millisecondi, i singoli componenti di timeout di un'operazione di invio/ricezione.
WaitForResponse	Specifica il tempo di attesa, espresso in secondi, per il completamento di un metodo Send asincrono, con valore di timeout facoltativo.

Proprietà

L'oggetto WinHttpRequest ha queste proprietà.

Proprietà	Tipo di accesso	Descrizione
Opzione	Lettura/Scrittura	Imposta o recupera un valore di opzione WinHTTP.
ResponseBody	Sola lettura	Recupera il corpo dell'entità di risposta come matrice di byte senza segno.
Responsestream	Sola lettura	Recupera il corpo dell'entità di risposta come IStream.
ResponseText	Sola lettura	Recupera il corpo dell'entità di risposta come testo.
Stato	Sola lettura	Recupera il codice di stato HTTP dall'ultima risposta.
StatusText	Sola lettura	Recupera il testo dello stato HTTP.

Commenti

L'oggetto WinHttpRequest usa l'interfaccia IErrorInfo per fornire i dati degli errori. È possibile ottenere una descrizione e un valore di errore numerico con l'oggetto Err in Microsoft Visual Basic Scripting Edition (VBScript) e l'oggetto Error in Microsoft JScript. I 16 bit inferiori di un numero di errore corrispondono ai valori trovati in Messaggi di errore.

Nota

Per Windows XP e Windows 2000, vedere Requisiti di runtime.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP, Windows 2000 Professional con SP3 [solo app desktop]
Server minimo supportato	Windows Server 2003, Windows 2000 Server con SP3 [solo app desktop]
Componente ridistribuibile	WinHTTP 5.0 e Internet Explorer 5.01 o versione successiva in Windows XP e Windows 2000.
IDL	HttpRequest.idl
Libreria	Winhttp.lib
DLL	Winhttp.dll

Vedi anche

Versioni di WinHTTP

Condividi tramite