CHttpConnection::OpenRequest

Article
03/04/2013

Appelez la fonction membre pour ouvrir une connexion 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 
);

Paramètres

pstrVerb
Un pointeur vers une chaîne contenant le verbe à utiliser dans la requête.Si NULL, « obtention » est utilisé.
pstrObjectName
Un pointeur vers une chaîne contenant l'objet cible du verbe spécifié.C'est en général un nom de fichier, un module exécutable, ou un spécificateur de recherche.
pstrReferer
Un pointeur vers une chaîne qui spécifie l'adresse (URL) du document à partir duquel l'URL de la demandepstrObjectName() a été obtenu.Si NULL, aucun en-tête HTTP est spécifié.
dwContext
l'identificateur de contexte pour l'exécution d' OpenRequest .Consultez Notes pour plus d'informations sur dwContext.
ppstrAcceptTypes
Un pointeur vers un tableau se terminant par null de pointeurs d' LPCTSTR aux chaînes qui indique les types de contenu reçus par le client.Si les ppstrAcceptTypes est NULL, les serveurs interprètent que le client n'accepte que des documents de type « text/* » (autrement dit, seuls les documents texte et des images ou d'autres fichiers binaires).Le type de contenu est équivalent à la variable CONTENT_TYPE de CGI, qui identifie le type de données pour les requêtes qui ont associé des informations, telles que la publication HTTP et MIS.
pstrVersion
Un pointeur vers une chaîne qui définit la version HTTP.Si NULL, « HTTP/1.0 » est utilisé.
dwFlags
Toute combinaison des balises d'INTERNET_ FLAG_*.Consultez Notes pour une description des valeurs possibles d' dwFlags .
nVerb
Un numéro associé au type de requête HTTP.Il peut s'agir de l'une des valeurs suivantes :

Type de requête HTTP

Valeur de 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

Type de requête HTTP	Valeur de 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

Valeur de retour

Pointeur vers l'objet de CHttpFile demandé.

Notes

dwFlags peut avoir l'une des valeurs suivantes :

Balise Internet	Description
INTERNET_FLAG_RELOAD	Force un téléchargement du fichier, l'objet, ou dans la liste de dossiers demandé du serveur d'origine, et non du cache.
INTERNET_FLAG_DONT_CACHE	n'ajoute pas l'entité retournée au cache.
INTERNET_FLAG_MAKE_PERSISTENT	Ajoute l'entité retournée au cache en tant qu'entité persistant.Cela signifie que standard mettez en cache le nettoyage, cohérence vérification, ou le garbage collection ne peut pas supprimer cet élément du cache.
INTERNET_FLAG_SECURE	Utilise la sémantique de transaction sécurisé.Cela traduit à utiliser SSL/PCT et est uniquement explicite dans les requêtes HTTP
INTERNET_FLAG_NO_AUTO_REDIRECT	Utilisé uniquement avec HTTP, spécifie que les redirections ne doivent pas être gérées automatiquement dans CHttpFile::SendRequest.

Remplacez la valeur par défaut d' dwContext pour définir l'ID de contexte à une valeur de votre choix.L'identificateur de contexte est associé à cette opération spécifique de l'objet d' CHttpConnection créé par son objet de CInternetSession .La valeur est retournée à CInternetSession::OnStatusCallback pour fournir le rapport état de l'exécution avec laquelle il est identifié.Consultez l'article Premières étapes Internet : WinInet pour plus d'informations sur l'identificateur de contexte.