IWinHttpRequest-Schnittstelle

Die IWinHttpRequest-Schnittstelle stellt alle Nichtereignismethoden für Microsoft Windows HTTP Services (WinHTTP)bereit.

Member

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

Methoden

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

Methode BESCHREIBUNG
Abbrechen 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 die automatische Anmeldung fest.
SetClientCertificate Wählt ein Clientzertifikat aus, das an einen HTTPS-Server (Secure Hypertext Transfer Protocol) gesendet werden soll.
Setcredentials Legt die 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 Time out-Komponenten eines Sende-/Empfangsvorgangs in Millisekunden an.
WaitForResponse Wartet auf den Abschluss einer asynchronen Send-Methode mit optionalem Time out-Wert in Sekunden.

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-Statuscode aus der letzten Antwort.
StatusText
Schreibgeschützt
Der HTTP-Statustext.

Hinweise

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 einer Klassen-ID von CLSID _ WinHttpRequest und einer Schnittstellen-ID von IID _ IWinHttpRequest aufruft.

Hinweis

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

Anforderungen

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

Weitere Informationen

IWinHttpRequestEvents

WinHTTP-Versionen