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 |
|
| Bibliothek |
|
| DLL |
|