CHttpConnection::OpenRequest

Artykuł
06/10/2015

Wywołanie tej funkcji członka 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 typu Ciąg zawierającą czasownik służy w żądaniu.Jeśli NULL, "GET" jest używany.
pstrObjectName
Wskaźnik do ciąg zawierający obiekt docelowy określonego zlecenia.Na ogół jest to nazwa pliku, modułu wykonywalnego lub specyfikator wyszukiwania.
pstrReferer
Wskaźnik do ciąg, który określa adres (URL) dokumentu, z którego URL we wniosku (pstrObjectName) został uzyskany.Jeśli NULL, bez nagłówka HTTP jest określony.
dwContext
Identyfikator kontekstu dla OpenRequest operacji.Zobacz sekcję Spostrzeżenia, aby uzyskać więcej informacji dwContext.
ppstrAcceptTypes
Wskaźnik tablicy zerową LPCTSTR wskaźniki do ciągów wskazująca typy zawartości zaakceptowane przez klienta.Jeśli ppstrAcceptTypes jest NULL, serwery interpretować, że klient akceptuje tylko dokumenty typu "text / *" (czyli tylko dokumenty tekstowe 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
Każda kombinacja flag INTERNET_ FLAG_ *.Zobacz sekcję Spostrzeżenia opis możliwych dwFlags wartości.
nVerb
Numer skojarzony z typem żądania HTTP.Może mieć postać:

Typ żądania HTTP

Wartość wyliczenia nVerb

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	Wartość wyliczenia nVerb
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 obiektu żądana.

Uwagi

dwFlags może mieć postać:

Flaga Internet	Opis
INTERNET_FLAG_RELOAD	Wymuszenie pobrania żądanego pliku, obiektu lub listy katalogów z serwera pochodzenia, a nie z pamięci podręcznej.
INTERNET_FLAG_DONT_CACHE	Nie dodaje encji zwróconych do pamięci podręcznej.
INTERNET_FLAG_MAKE_PERSISTENT	Dodaje obiekt zwrócony w pamięci podręcznej jako podmiot trwałe.Oznacza to, że czyszczenie pamięci podręcznej standardowe, sprawdzanie spójności lub wyrzucania elementów bezużytecznych nie może usunąć tego elementu z pamięci podręcznej.
INTERNET_FLAG_SECURE	Semantyka bezpieczna transakcja zastosowań.To przekłada się na stosowanie protokołu SSL/PCT i jest przydatny w żądaniach HTTP tylko
INTERNET_FLAG_NO_AUTO_REDIRECT	Używany tylko z protokołem HTTP, określa, że przekierowania nie powinien automatycznie obsługiwany w CHttpFile::SendRequest.

Zastąpić dwContext domyślne, aby ustawić identyfikator kontekstu wartość wybranego przez użytkownika.Identyfikator kontekstu jest skojarzony z tym działania związane z CHttpConnection obiektu utworzonego przez jego CInternetSession obiektu.Wartość jest zwracana do CInternetSession::OnStatusCallback o stanie na operacji, z którą jest identyfikowana.Zapoznaj się z artykułem pierwsze kroki Internet: WinInet uzyskać więcej informacji o identyfikator kontekstu.

Wyjątki mogą zostać wygenerowany za pomocą tej funkcji.