CHttpConnection::OpenRequest

Artikel
02/26/2013

Rufen Sie die Memberfunktion auf, um eine HTTP-Verbindung zu öffnen.

CHttpFile* OpenRequest(
   LPCTSTR pstrVerb,
   LPCTSTR pstrObjectName,
   LPCTSTR pstrReferer = NULL,
   DWORD_PTR dwContext = 1,
   LPCTSTR* ppstrAcceptTypes = NULL,
   LPCTSTR pstrVersion = NULL,
   DWORD dwFlags = INTERNET_FLAG_EXISTING_CONNECT 
);
CHttpFile* OpenRequest(
   int nVerb,
   LPCTSTR pstrObjectName,
   LPCTSTR pstrReferer = NULL,
   DWORD_PTR dwContext = 1,
   LPCTSTR* ppstrAcceptTypes = NULL,
   LPCTSTR pstrVersion = NULL,
   DWORD dwFlags = INTERNET_FLAG_EXISTING_CONNECT 
);

Parameter

pstrVerb
Ein Zeiger auf eine Zeichenfolge, die das Verb enthält, die in der Anforderung zu verwenden.Wenn NULL, "GET" verwendet wird.
pstrObjectName
Ein Zeiger auf eine Zeichenfolge, die das Zielobjekt des angegebenen Verbs enthält.Dies ist im Allgemeinen ein Dateiname, ein ausführbares Modul oder ein Suchenspezifizierer.
pstrReferer
Ein Zeiger auf eine Zeichenfolge, die die Adresse (URL) des Dokuments angibt, aus dem die URL in der Anforderung (pstrObjectName) abgerufen wurde.Wenn NULL, kein HTTP-Header angegeben wird.
dwContext
Der Kontextbezeichner OpenRequest für den Vorgang.Siehe Remarks weitere Informationen zu dwContext.
ppstrAcceptTypes
Ein Zeiger auf ein mit Null endendes Array LPCTSTR Zeigern in Zeichenfolgen die Inhaltstypen wird vom Client akzeptiert.Wenn ppstrAcceptTypes NULL ist, interpretieren die Server, dass der Client nur Dokumente des Typs "text/*" akzeptiert, also nur Textdokumente und nicht Bilder oder anderer Binärdateien).Der Inhaltstyp ist zur CGI-Variable CONTENT_TYPE, die den Typ von Daten für Abfragen identifiziert, die Informationen angefügt haben, wie HTTP POST und PUT entsprechend.
pstrVersion
Ein Zeiger auf eine Zeichenfolge die HTTP-Version definiert.Wenn NULL, "HTTP/1.0" verwendet wird.
dwFlags
Eine beliebige Kombination der Flags INTERNET_ FLAG_*.Siehe Remarks für eine Beschreibung möglicher dwFlags-Werten.
nVerb
Eine Zahl mit dem HTTP-Anforderungs-Typ zugeordnet.Einer der folgenden Werte ist möglich:

HTTP-Anforderungs-Typ

nVerb-Wert

HTTP_VERB_POST

0

HTTP_VERB_GET

1

HTTP_VERB_HEAD

2

HTTP_VERB_PUT

3

HTTP_VERB_LINK

4

HTTP_VERB_DELETE

5

HTTP_VERB_UNLINK

6

HTTP-Anforderungs-Typ	nVerb-Wert
HTTP_VERB_POST	0
HTTP_VERB_GET	1
HTTP_VERB_HEAD	2
HTTP_VERB_PUT	3
HTTP_VERB_LINK	4
HTTP_VERB_DELETE	5
HTTP_VERB_UNLINK	6

Rückgabewert

Ein Zeiger auf CHttpFile-Objekt angefordert.

Hinweise

dwFlags einer der folgenden Werte ist möglich:

Internet-Flag	Description
INTERNET_FLAG_RELOAD	Erzwingt einen Download der angeforderten Datei, des Objekts oder der Verzeichnisliste aus dem ursprünglichen Server, nicht im Cache.
INTERNET_FLAG_DONT_CACHE	Fügt die zurückgegebene Entität nicht dem Cache hinzu.
INTERNET_FLAG_MAKE_PERSISTENT	Fügt die zurückgegebene Entität dem Cache als dauerhafte Entität hinzu.Dies bedeutet, dass Standardcachebereinigung, Konsistenzüberprüfung oder Garbage Collection dieses Element nicht aus dem Cache entfernen können.
INTERNET_FLAG_SECURE	Transaktionssemantik verwendet wird.Dieses übersetzt zur Anwendung von SSL/PCT und in den HTTP-Anforderungen nur Sinn
INTERNET_FLAG_NO_AUTO_REDIRECT	Wird nur mit HTTP, gibt an, dass Umleitungen nicht in CHttpFile::SendRequest automatisch behandelt werden sollen.

Überschreiben Sie den dwContext Standard, um den Kontextbezeichner zu einem Wert der Auswahl festzulegen.Der Kontextbezeichner wird mit diesem Einzelgeschäft CHttpConnection des Objekts zugeordnet, das durch sein CInternetSession-Objekt erstellt wird.Der Wert wird auf CInternetSession::OnStatusCallback zurückgegeben, um den Status von dem Vorgang bereitzustellen, mit dem die identifiziert wird.Weitere Informationen finden Sie im Artikel Internet-erste Schritte: WinInet-Klassen weitere Informationen über den Kontextbezeichner.