CHttpConnection::OpenRequest

Article
06/10/2015

Appelez cette 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 demande. Si NULL, « GET » 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 dans lequel l'URL de la demande (pstrObjectName) a été obtenu. Si la valeur est NULL, aucune en tête HTTP n'est spécifiée.
dwContext
L'identificateur de contexte pour l'opération OpenRequest. Pour plus d'informations sur dwContext, consultez la section Notes.
ppstrAcceptTypes
Pointeur vers un tableau de pointeurs aux chaînes affichant les types de contenu acceptés par le client LPCTSTR se terminant par null. Si ppstrAcceptTypes est NULL, les serveurs interprètent que le client n'accepte que des documents de type « text/* » (autrement dit, les documents texte et non 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 attaché des informations, telles que HTTP POST et PUT.
pstrVersion
Un pointeur vers une chaîne définissant la version HTTP. Si NULL, « HTTP/1.0 » est utilisé.
dwFlags
Toute combinaison des indicateurs INTERNET_ FLAG_*. Pour une description des valeurs possibles pour dwFlags, reportez vous à la section remarques.
nVerb
Un numéro associé au type de requête HTTP. Il peut s'agir de l'une des valeurs suivantes :

Type de la 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 la 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 :

Indicateur Internet	Description
INTERNET_FLAG_RELOAD	Force un téléchargement du fichier, objet, ou de la liste des répertoires demandé depuis le serveur d'origine, et non le cache.
INTERNET_FLAG_DONT_CACHE	N'ajoutez pas l'entité retournée au cache.
INTERNET_FLAG_MAKE_PERSISTENT	Ajoute l'entité retournée au cache en tant qu'entité persistante. Cela signifie que le nettoyage de cache standard, la vérification de cohérence, ou la garbage collection ne peuvent pas supprimer cet élément du cache.
INTERNET_FLAG_SECURE	Utilise la sémantique de transaction sécurisée. Cela revient à utiliser SSL/PCT et n'a du sens que pour 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.

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

Les exceptions peuvent être levées avec cette fonction.