CHttpConnection::OpenRequest

Artikel
06/10/2015

Rufen Sie diese 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, das in der Anforderung verwendet werden soll. Wenn NULL, wird "GET" verwendet.
pstrObjectName
Ein Zeiger auf eine Zeichenfolge, die das Zielobjekt des angegebenen Verbs enthält. Dies ist in der Regel ein Dateiname, ein ausführbares Modul oder ein Suchspezifizierer.
pstrReferer
Ein Zeiger auf eine Zeichenfolge, mit der die Adresse (URL) des Dokuments angegeben wird, von dem die URL der Anforderung (pstrObjectName) abgerufen wurde. Wenn NULL, wird kein HTTP-Header angegeben.
dwContext
Der Kontextbezeichner für den OpenRequest-Vorgang. Weitere Informationen zu dwContext finden Sie im Abschnitt "Hinweise".
ppstrAcceptTypes
Ein Zeiger auf ein mit NULL endendes Array von LPCTSTR-Zeigern auf Zeichenfolgen, die durch den Client akzeptierte Inhaltstypen angeben. Wenn ppstrAcceptTypes den Wert NULL hat, wird von den Server interpretiert, dass der Client nur Dokumente des Typs "text/*" akzeptiert (also nur Textdokumente, keine Bilder oder andere Binärdateien). Der Inhaltstyp entspricht der CGI-Variable CONTENT_TYPE, die den Typ der Daten für Abfragen kennzeichnet, denen Informationen wie HTTP POST und PUT angefügt sind.
pstrVersion
Ein Zeiger auf eine Zeichenfolge, mit der die HTTP-Version definiert wird. Wenn NULL, wird "HTTP/1.0" verwendet.
dwFlags
Beliebige Kombinationen der Flags INTERNET_ FLAG_*. Eine Beschreibung möglicher dwFlags-Werte finden Sie im Abschnitt "Hinweise".
nVerb
Eine mit dem HTTP-Anforderungstyp verknüpfte Zahl. Einer der folgenden Werte ist möglich:

HTTP-Anforderungstyp

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-Anforderungstyp	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 das angeforderte CHttpFile-Objekt.

Hinweise

dwFlags kann eines der folgenden Elemente sein:

Internet-Flag	Beschreibung
INTERNET_FLAG_RELOAD	Erzwingt einen Download der angeforderten Datei, des angeforderten Objekts oder der angeforderten Verzeichnisliste vom ursprünglichen Server, nicht aus dem 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 permanente Entität hinzu. Dies bedeutet, dass die Standardcachebereinigung, Konsistenzüberprüfung oder Garbage Collection dieses Element nicht aus dem Cache entfernen kann.
INTERNET_FLAG_SECURE	Verwendung eine sichere Transaktionssemantik. Dies wird für die Verwendung von SSL/PCT übersetzt und ist nur in HTTP-Anforderungen sinnvoll.
INTERNET_FLAG_NO_AUTO_REDIRECT	Wird ausschließlich mit HTTP verwendet, gibt an, dass Umleitungen in CHttpFile::SendRequest nicht automatisch bearbeitet werden sollen.

Überschreiben Sie den dwContext-Standard, um den Kontextbezeichner auf einen ausgewählten Wert festzulegen. Der Kontextbezeichner wird diesem bestimmten Vorgang des CHttpConnection-Objekts zugeordnet, das vom CInternetSession-Objekt erstellt wird. Der Wert wird an CInternetSession::OnStatusCallback zurückgegeben, um den Status des Vorgangs bereitzustellen, mit dem es identifiziert wird. Weitere Informationen über den Kontextbezeichner finden Sie im Artikel über Internetgrundlagen: WinInet.

Mit dieser Funktion können Ausnahmen ausgelöst werden.