CHttpConnection::OpenRequest

Artykuł
02/27/2013

Wywołanie tej funkcji Członkowskich do otwarcia połączenia HTTP.

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 
);

Parametry

pstrVerb
Wskaźnik ciąg zawierający zlecenie w żądaniu.Jeśli NULL, "GET" jest używany.
pstrObjectName
Wskaźnik ciąg zawierający obiekt docelowy określonego zlecenia.Jest to zwykle nazwę pliku, modułu wykonywalnego lub specyfikator wyszukiwania.
pstrReferer
Ciąg, który określa adres (URL) dokumentu, z którego wskaźnik URL w żądaniu (pstrObjectName) została uzyskana.Jeśli NULL, bez nagłówka HTTP jest określony.
dwContext
Identyfikator kontekstu dla OpenRequest operacji.Zobacz uwagi uzyskać więcej informacji o dwContext.
ppstrAcceptTypes
Wskaźnik zerem tablicy LPCTSTR do łańcuchów wskazujące typy zawartości są akceptowane przez klienta.Jeśli ppstrAcceptTypes jest NULL, serwery interpretować klient akceptuje tylko dokumenty typu "tekst / *" (czyli dokumentów tekstowych i nie obrazy lub inne pliki binarne).Typ zawartości jest równoważne CONTENT_TYPE zmiennej CGI, który identyfikuje typ danych dla kwerendy, które mają przyłączone informacje, takie jak HTTP POST i PUT.
pstrVersion
Wskaźnik ciągiem definiującym wersji HTTP.Jeśli NULL, "HTTP/1.0" jest używany.
dwFlags
Dowolna kombinacja flag INTERNET_ FLAG_ *.Zobacz uwagi opis możliwych dwFlags wartości.
nVerb
Numer skojarzony typ żądania HTTP.Może być jedną z następujących czynności:

Typ żądania HTTP

nVerbwartość

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

Typ żądania HTTP	nVerbwartość
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

Wartość zwracana

Wskaźnik do CHttpFile żądany obiekt.

Uwagi

dwFlagsmoże być jedną z następujących czynności:

Flaga Internet	Opis
INTERNET_FLAG_RELOAD	Wymusza pobierania żądanego pliku, obiektu lub listy katalogów z serwera pochodzenia, a nie z pamięci podręcznej.
INTERNET_FLAG_DONT_CACHE	Nie dodaje podmiot zwracane do pamięci podręcznej.
INTERNET_FLAG_MAKE_PERSISTENT	Dodaje podmiot zwracane do pamięci podręcznej jako podmiot trwałe.Oznacza to, że czyszczenie pamięci podręcznej standardowych, sprawdzanie spójności lub kolekcji garbage nie może usunąć ten element z pamięci podręcznej.
INTERNET_FLAG_SECURE	Semantyka bezpiecznych transakcji zastosowań.To tłumaczy się przy użyciu protokołu SSL/PCT i jest przydatny w przypadku żądań HTTP tylko
INTERNET_FLAG_NO_AUTO_REDIRECT	Używany tylko z protokołu HTTP, określa, że przekierowania nie powinien automatycznie obsługiwane w CHttpFile::SendRequest.

Zastąpić dwContext domyślne, aby ustawić identyfikator kontekstu wartość wybrane.Identyfikator kontekstu jest skojarzony z tym działania związane z CHttpConnection obiekt utworzony przez jego CInternetSession obiektu.Wartość jest zwracana do CInternetSession::OnStatusCallback zapewnienie stan operacji, z którym jest identyfikowana.Zobacz artykuł pierwsze kroki Internet: WinInet uzyskać więcej informacji dotyczących identyfikatora kontekstu.