CHttpConnection::OpenRequest

Articolo
03/05/2013

Chiamare la 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 verbo da utilizzare nella richiesta.Se NULL, "GET" viene utilizzato.
pstrObjectName
Un puntatore a una stringa contenente l'oggetto di destinazione del verbo specificato.Questo rappresenta in genere un nome file, un modulo eseguibile, o un identificatore.
pstrReferer
Un puntatore a una stringa che specifica l'indirizzo (URL) del documento dall'URL della richiesta (pstrObjectName) è stato ottenuto.Se NULL, alcuna intestazione HTTP è specificato.
dwContext
l'identificatore di contesto per l'operazione OpenRequest.Vedere Note per ulteriori informazioni su dwContext.
ppstrAcceptTypes
Puntatore a matrice con terminazione null di puntatori LPCTSTR le stringhe che identificano i tipi di contenuto accettati dal client.Se i ppstrAcceptTypes è NULL, i server HTML 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, "HTTP/1.0" viene utilizzato.
dwFlags
Qualsiasi combinazione di flag di INTERNET_ FLAG_*.Vedere Note per una descrizione dei valori possibili dwFlags.
nVerb
Un numero associato al tipo di richiesta HTTP.ad esempio uno dei seguenti:

Tipo di 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 di 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:

Flag Internet	Descrizione
INTERNET_FLAG_RELOAD	Impone un download del file, oggetti, o della visualizzazione directory richiesto dal server di origine, non dalla cache.
INTERNET_FLAG_DONT_CACHE	Non aggiunge l'output nella cache.
INTERNET_FLAG_MAKE_PERSISTENT	Aggiunge l'entità restituita alla cache come entità persistente.Ciò significa che standard memorizzare nella cache la pulizia, controllo di consistenza, o il Garbage Collection non può eliminare l'elemento dalla cache.
INTERNET_FLAG_SECURE	Utilizza garantiscono la semantica delle transazioni.Si converte un oggetto utilizzando 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 del valore predefinito dwContext per impostare l'identificatore di contesto a un valore desiderato.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 passaggi Internet: WinInet per ulteriori informazioni sull'identificatore di contesto.