WinHttpRequest-Objekt

Artikel
06/13/2023

Dieses Thema enthält Informationen zur Verwendung des WinHTTP WinHttpRequest-COM-Objekts mit Skriptsprachen. Weitere Informationen, einschließlich der C++-API (WinHTTP) finden Sie unter Informationen zu WinHTTP. Einen Vergleich dieser Schnittstellen finden Sie unter Auswählen einer WinHTTP-Schnittstelle .

Beispiel

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

Codebeispiele aus der IWinHttpRequest::Status-Eigenschaft.

Member

Das WinHttpRequest-Objekt verfügt über folgende Membertypen:

Ereignisse
Methoden
Eigenschaften

Ereignisse

Das WinHttpRequest-Objekt weist diese Ereignisse auf.

Ereignis	Beschreibung
OnError	Tritt auf, wenn in der Anwendung ein Laufzeitfehler vorliegt.
OnResponseDataAvailable	Tritt auf, wenn Daten aus der Antwort verfügbar sind.
OnResponseFinished	Tritt auf, wenn die Antwortdaten vollständig sind.
OnResponseStart	Tritt auf, wenn die Antwortdaten empfangen werden.

Methoden

Das WinHttpRequest-Objekt verfügt über diese Methoden.

Methode	Beschreibung
Abbruch	Bricht eine WinHTTP Send-Methode ab .
GetAllResponseHeaders	Ruft alle HTTP-Antwortheader ab.
GetResponseHeader	Ruft die HTTP-Antwortheader ab.
Öffnen	Öffnet eine HTTP-Verbindung mit einer HTTP-Ressource.
Senden	Sendet eine HTTP-Anforderung an einen HTTP-Server.
SetAutoLogonPolicy	Legt die aktuelle Richtlinie für automatische Anmeldung fest.
SetClientCertificate	Wählt ein Clientzertifikat aus, das an einen HTTPS-Server (Secure Hypertext Transfer Protocol) gesendet werden soll.
Setcredentials	Legt Anmeldeinformationen fest, die mit einem HTTP-Server entweder einem Ursprung oder einem Proxyserver verwendet werden sollen.
SetProxy	Legt Proxyserverinformationen fest.
SetRequestHeader	Fügt einen HTTP-Anforderungsheader hinzu, ändert oder löscht diesen.
SetTimeouts	Gibt in Millisekunden die einzelnen Timeoutkomponenten eines Sende-/Empfangsvorgangs an.
WaitForResponse	Gibt die Wartezeit in Sekunden für den Abschluss einer asynchronen Send-Methode mit optionalem Timeoutwert an.

Eigenschaften

Das WinHttpRequest-Objekt verfügt über diese Eigenschaften.

Eigenschaft	Zugriffstyp	BESCHREIBUNG
Option	Lesen/Schreiben	Legt einen WinHTTP-Optionswert fest oder ruft diesen ab.
ResponseBody	Schreibgeschützt	Ruft den Antwortentitätstext als Array von Bytes ohne Vorzeichen ab.
ResponseStream	Schreibgeschützt	Ruft den Antwortentitätstext als IStream ab.
Responsetext	Schreibgeschützt	Ruft den Antwortentitätstext als Text ab.
Status	Schreibgeschützt	Ruft den HTTP-status Code aus der letzten Antwort ab.
Statustext	Schreibgeschützt	Ruft HTTP-status Text ab.

Bemerkungen

Das WinHttpRequest-Objekt verwendet die IErrorInfo-Schnittstelle , um Fehlerdaten bereitzustellen. Eine Beschreibung und ein numerischer Fehlerwert können mit dem Err-Objekt in Microsoft Visual Basic Scripting Edition (VBScript) und dem Error-Objekt in Microsoft JScript abgerufen werden. Die unteren 16 Bits einer Fehlernummer entsprechen den Werten in Fehlermeldungen.

Hinweis

Informationen zu Windows XP und Windows 2000 finden Sie unter Laufzeitanforderungen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional mit SP3 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003, Windows 2000 Server mit SP3 [nur Desktop-Apps]
Verteilbare Komponente	WinHTTP 5.0 und Internet Explorer 5.01 oder höher unter Windows XP und Windows 2000.
IDL	HttpRequest.idl
Bibliothek	Winhttp.lib
DLL	Winhttp.dll

Siehe auch

WinHTTP-Versionen