WinHttpRequest-Objekt
Dieses Thema enthält Informationen zur Verwendung des WinHTTP WinHttpRequest-COM-Objekts mit Skriptsprachen. Weitere Informationen, einschließlich der C++-API (WinHTTP) finden Sie unter Informationen zu WinHTTP. Einen Vergleich dieser Schnittstellen finden Sie unter Auswählen einer WinHTTP-Schnittstelle .
Beispiel
// Instantiate a WinHttpRequest object.
var WinHttpReq = new ActiveXObject("WinHttp.WinHttpRequest.5.1");
IWinHttpRequest * pIWinHttpRequest = NULL;
\\..
hr = CLSIDFromProgID(L"WinHttp.WinHttpRequest.5.1", &clsid);
if (SUCCEEDED(hr))
{
hr = CoCreateInstance(clsid, NULL,
CLSCTX_INPROC_SERVER,
IID_IWinHttpRequest,
(void **)&pIWinHttpRequest);
}
Codebeispiele aus der IWinHttpRequest::Status-Eigenschaft.
Member
Das WinHttpRequest-Objekt verfügt über folgende Membertypen:
Ereignisse
Das WinHttpRequest-Objekt weist diese Ereignisse auf.
| Ereignis | Beschreibung |
|---|---|
| OnError | Tritt auf, wenn in der Anwendung ein Laufzeitfehler vorliegt. |
| OnResponseDataAvailable | Tritt auf, wenn Daten aus der Antwort verfügbar sind. |
| OnResponseFinished | Tritt auf, wenn die Antwortdaten vollständig sind. |
| OnResponseStart | Tritt auf, wenn die Antwortdaten empfangen werden. |
Methoden
Das WinHttpRequest-Objekt verfügt über diese Methoden.
| Methode | Beschreibung |
|---|---|
| Abbruch | Bricht eine WinHTTPSend-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 entweder einem Ursprung oder einem Proxyserver verwendet werden sollen. |
| SetProxy | Legt Proxyserverinformationen fest. |
| SetRequestHeader | Fügt einen HTTP-Anforderungsheader hinzu, ändert oder löscht diesen. |
| SetTimeouts | Gibt in Millisekunden die einzelnen Timeoutkomponenten eines Sende-/Empfangsvorgangs an. |
| WaitForResponse | Gibt die Wartezeit in Sekunden für den Abschluss einer asynchronen Send-Methode mit optionalem Timeoutwert an. |
Eigenschaften
Das WinHttpRequest-Objekt verfügt über diese Eigenschaften.
| Eigenschaft | Zugriffstyp | BESCHREIBUNG |
|---|---|---|
|
Option |
Lesen/Schreiben |
Legt einen WinHTTP-Optionswert fest oder ruft diesen ab. |
|
ResponseBody |
Schreibgeschützt |
Ruft den Antwortentitätstext als Array von Bytes ohne Vorzeichen ab. |
|
ResponseStream |
Schreibgeschützt |
Ruft den Antwortentitätstext als IStream ab. |
|
Responsetext |
Schreibgeschützt |
Ruft den Antwortentitätstext als Text ab. |
|
Status |
Schreibgeschützt |
Ruft den HTTP-status Code aus der letzten Antwort ab. |
|
Statustext |
Schreibgeschützt |
Ruft HTTP-status Text ab. |
Bemerkungen
Das WinHttpRequest-Objekt verwendet die IErrorInfo-Schnittstelle , um Fehlerdaten bereitzustellen. Eine Beschreibung und ein numerischer Fehlerwert können mit dem Err-Objekt in Microsoft Visual Basic Scripting Edition (VBScript) und dem Error-Objekt in Microsoft JScript abgerufen werden. Die unteren 16 Bits einer Fehlernummer entsprechen den Werten in Fehlermeldungen.
Hinweis
Informationen zu Windows XP und Windows 2000 finden Sie unter Laufzeitanforderungen.
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 |
|