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