CHttpConnection::OpenRequest

Articolo
06/10/2015

Chiamare la seguente funzione membro per aprire una connessione 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 
);

Parametri

pstrVerb
Un puntatore a una stringa contenente il metodo da utilizzare nella richiesta. Se NULL, viene utilizzato "GET".
pstrObjectName
Un puntatore a una stringa contenente l'oggetto di destinazione del metodo specificato. Questo rappresenta in genere un nome di file, un modulo eseguibile, o un identificatore di ricerca.
pstrReferer
Un puntatore a una stringa che specifica l'indirizzo (URL) del documento dal quale l'URL della richiesta (pstrObjectName) è stato ottenuto. Se NULL, non viene specificata alcuna intestazione HTTP.
dwContext
L'identificatore di contesto per l'operazione OpenRequest. Per ulteriori informazioni su dwContext, vedere la sezione Osservazioni.
ppstrAcceptTypes
Un puntatore ad un array con terminazione null di LPCTSTR punta alle stringhe che identificano i tipi di contenuto accettati dal client. Se ppstrAcceptTypes è NULL, i server interpretano che il client accetta solo i documenti di tipo "text/*" (ovvero solo documenti di testo e non immagini o altri file binari). Il tipo di contenuto è equivalente alla variabile CONTENT_TYPE di CGI, che identifica il tipo di dati per le query con allegato di informazioni, quali HTTP POST e PUT.
pstrVersion
Un puntatore a una stringa che definisce la versione HTTP. Se NULL, viene utilizzato "HTTP/1.0".
dwFlags
Qualsiasi combinazione dei flag INTERNET_ FLAG_*. Per una descrizione dei possibili valori dwFlags, vedere la sezione Note.
nVerb
Un numero associato al tipo di richiesta HTTP. ad esempio uno dei seguenti:

Tipo richiesta HTTP

Valore 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

Tipo richiesta HTTP	Valore 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

Valore restituito

Un puntatore all'oggetto CHttpFile richiesto.

Note

dwFlags può essere uno dei seguenti:

Flag internet	Descrizione
INTERNET_FLAG_RELOAD	Impone un download del file richiesto, dell'oggetto, o della visualizzazione della directory dal server di origine, non dalla cache.
INTERNET_FLAG_DONT_CACHE	Non aggiunge l'entità restituita alla cache.
INTERNET_FLAG_MAKE_PERSISTENT	Aggiunge l'entità restituita alla cache come entità persistente. Ciò significa che la pulizia standard della cache, controllo di consistenza, o il Garbage Collection non può eliminare l'elemento dalla cache.
INTERNET_FLAG_SECURE	Utilizza semantica sicura delle transazioni. Si traduce nell'utilizzare SSL/PCT ed è significativa solo nelle richieste HTTP
INTERNET_FLAG_NO_AUTO_REDIRECT	Utilizzato solo con HTTP, specifica che i reindirizzamenti non devono essere gestiti automaticamente in CHttpFile::SendRequest.

Eseguire l'override dell'impostazione predefinita dwContext per impostare l'identificatore di contesto a un valore di propria scelta. L'identificatore di contesto è associato a questa operazione specifica dell'oggetto CHttpConnection creato dal relativo oggetto CInternetSession. Il valore viene restituito a CInternetSession::OnStatusCallback per fornire lo stato sull'operazione con cui viene identificato. Vedere l'articolo Primi Passi Internet: WinInet per ulteriori informazioni sull'identificatore di contesto.

Dalla funzione possono essere generate eccezioni.