Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die IWinHttpRequest-Schnittstelle stellt alle nichtevent-Methoden für Microsoft Windows HTTP-Dienste (WinHTTP) bereit.
Elemente
Die IWinHttpRequest-Schnittstelle erbt von der IUnknown-Schnittstelle . IWinHttpRequest verfügt auch über die folgenden Typen von Mitgliedern:
Methodik
Die IWinHttpRequest-Schnittstelle verfügt über diese Methoden.
| Method | Description |
|---|---|
| Abbruch | Beendet eine WinHTTPSend-Methode . |
| 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 anmeldeinformationen fest, die mit einem HTTP-Server verwendet werden sollen, entweder einem Proxyserver oder einem ursprünglichen Server. |
| 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 auf den Abschluss einer asynchronen Send-Methode mit optionalem Timeoutwert in Sekunden. |
Eigenschaften
Die IWinHttpRequest-Schnittstelle verfügt über diese Eigenschaften.
| Eigentum | Zugriffstyp | Description |
|---|---|---|
|
Option |
Lesen/Schreiben |
Ein WinHTTP-Optionswert. |
|
ResponseBody |
Schreibgeschützt |
Der Antwortentitätstext als Array von nicht signierten Bytes. |
|
ResponseStream |
Schreibgeschützt |
Der Antwortentitätstext als IStream. |
|
ResponseText |
Schreibgeschützt |
Der Textkörper der Antwortentität. |
|
Status |
Schreibgeschützt |
Der HTTP-Statuscode aus der letzten Antwort. |
|
StatusText |
Schreibgeschützt |
Der HTTP-Statustext. |
Remarks
Die in "httprequest.idl" definierte IWinHttpRequest-Schnittstelle wird von einer Klasse mit der ID CLSID_WinHttpRequest implementiert. Eine Anwendung ruft diese Schnittstelle durch Aufrufen von CoCreateInstance mit einer Klassen-ID von CLSID_WinHttpRequest und einer Schnittstellen-ID von IID_IWinHttpRequest auf.
Note
Informationen zu Windows XP und Windows 2000 finden Sie im Abschnitt "Run-Time Anforderungen" der WinHttp-Startseite.
Anforderungen
| Anforderung | Wert |
|---|---|
| Mindestens unterstützter Client |
Windows XP, Windows 2000 Professional mit SP3 [nur Desktop-Apps] |
| Unterstützter Server (Mindestversion) |
Windows Server 2003, Windows 2000 Server mit SP3 [nur Desktop-Apps] |
| Verteilbar |
WinHTTP 5.0 und Internet Explorer 5.01 oder höher unter Windows XP und Windows 2000. |
| IDL |
|
| Bibliothek |
|
| DLL |
|