Interface IWinHttpRequest

De IWinHttpRequest-interface biedt alle nonevent-methoden voor Microsoft Windows HTTP Services (WinHTTP).

Leden

De interface IWinHttpRequest neemt de IUnknown-interface over. IWinHttpRequest heeft ook deze typen leden:

Methods

De IWinHttpRequest-interface heeft deze methoden.

Methode Description
Afbreken Hiermee wordt een WinHTTPSend-methode afgebroken.
GetAllResponseHeaders Hiermee worden alle HTTP-antwoordheaders opgehaald.
GetResponseHeader Haalt de HTTP-antwoordheaders op.
openen Hiermee opent u een HTTP-verbinding met een HTTP-resource.
Verzenden Verzendt een HTTP-aanvraag naar een HTTP-server.
SetAutoLogonPolicy Hiermee stelt u het huidige beleid voor automatische aanmelding in.
SetClientCertificate Selecteert een clientcertificaat dat moet worden verzonden naar een HTTPS-server (Secure Hypertext Transfer Protocol).
SetCredentials Hiermee stelt u referenties in die moeten worden gebruikt met een HTTP-server, een proxyserver of een oorspronkelijke server.
SetProxy Hiermee stelt u gegevens van de proxyserver in.
SetRequestHeader Voegt een HTTP-aanvraagheader toe, wijzigt of verwijdert.
SetTime-outs Hiermee geeft u de afzonderlijke time-outonderdelen van een verzend-/ontvangstbewerking, in milliseconden.
WaitForResponse Wacht totdat een asynchrone verzendmethode is voltooid, met optionele time-outwaarde in seconden.

Properties

De IWinHttpRequest-interface heeft deze eigenschappen.

Property Toegangstype Description
Optie
Lezen/schrijven
Een WinHTTP-optiewaarde.
ResponseBody
Read-only
De hoofdtekst van de antwoordentiteit als een matrix van niet-ondertekende bytes.
ResponseStream
Read-only
De hoofdtekst van de antwoordentiteit als een IStream.
ResponseText
Read-only
De hoofdtekst van de antwoordentiteit.
Status
Read-only
De HTTP-statuscode uit het laatste antwoord.
StatusTekst
Read-only
De HTTP-statustekst.

Remarks

De IWinHttpRequest-interface die is gedefinieerd in httprequest.idl, wordt geïmplementeerd door een klasse met id van CLSID_WinHttpRequest. Een toepassing verkrijgt deze interface door CoCreateInstance aan te roepen met een klasse-id van CLSID_WinHttpRequest en een interface-id van IID_IWinHttpRequest.

Note

Zie voor Windows XP en Windows 2000 de sectie Run-Time Vereisten van de Startpagina WinHttp.

Requirements

Requirement Value
Minimaal ondersteunde client
Windows XP, Windows 2000 Professional met SP3 [alleen desktop-apps]
Minimaal ondersteunde server
Windows Server 2003, Windows 2000 Server met SP3 [alleen desktop-apps]
Herdistribueerbaar
WinHTTP 5.0 en Internet Explorer 5.01 of hoger in Windows XP en Windows 2000.
IDL
HttpRequest.idl
Library
Winhttp.lib
DLL
Winhttp.dll

Zie ook

IWinHttpRequestEvents

WinHTTP-versies