IWinHttpRequest-Schnittstelle

  • Artikel

Die IWinHttpRequest-Schnittstelle stellt alle nicht ereignisfreien Methoden für Microsoft Windows HTTP-Dienste (WinHTTP) bereit.

Member

Die IWinHttpRequest-Schnittstelle erbt von der IUnknown-Schnittstelle . IWinHttpRequest verfügt auch über folgende Arten von Membern:

Methoden

Die IWinHttpRequest-Schnittstelle 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 verwendet werden sollen, entweder einem Proxyserver oder einem Ursprungsserver.
SetProxy Legt Proxyserverinformationen fest.
SetRequestHeader Fügt einen HTTP-Anforderungsheader hinzu, ändert oder löscht diesen.
SetTimeouts Gibt die einzelnen Timeoutkomponenten eines Sende-/Empfangsvorgangs in Millisekunden an.
WaitForResponse Wartet, bis eine asynchrone Send-Methode mit optionalem Timeoutwert in Sekunden abgeschlossen ist.

Eigenschaften

Die IWinHttpRequest-Schnittstelle verfügt über diese Eigenschaften.

Eigenschaft Zugriffstyp BESCHREIBUNG
Option
 Lesen/Schreiben
 Ein WinHTTP-Optionswert.
ResponseBody
 Schreibgeschützt
 Der Antwortentitätstext als Array von Bytes ohne Vorzeichen.
ResponseStream
 Schreibgeschützt
 Der Antwortentitätstext als IStream.
Responsetext
 Schreibgeschützt
 Der Antwortentitätstext.
Status
 Schreibgeschützt
 Der HTTP-status Code aus der letzten Antwort.
Statustext
 Schreibgeschützt
 Der HTTP-status Text.

Bemerkungen

Die in httprequest.idl definierte IWinHttpRequest-Schnittstelle wird von einer Klasse mit der ID CLSID_WinHttpRequest implementiert. Eine Anwendung ruft diese Schnittstelle ab, indem sie CoCreateInstance mit der Klassen-ID CLSID_WinHttpRequest und der Schnittstellen-ID IID_IWinHttpRequest aufruft.

Hinweis

Informationen zu Windows XP und Windows 2000 finden Sie im Abschnitt Laufzeitanforderungen der WinHttp-Startseite .

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

IWinHttpRequestEvents

WinHTTP-Versionen