CInternetSession::OpenURL
Appelez la fonction membre pour envoyer la demande spécifiée au serveur HTTP et permettre au client pour spécifier les en-têtes supplémentaires de RFC822, MIME, ou HTTP pour envoyer avec la demande.
CStdioFile* OpenURL(
LPCTSTR pstrURL,
DWORD_PTR dwContext = 1,
DWORD dwFlags = INTERNET_FLAG_TRANSFER_ASCII,
LPCTSTR pstrHeaders = NULL,
DWORD dwHeadersLength = 0
);
Paramètres
pstrURL
Pointeur vers le nom de l'URL pour démarrer la lecture. Uniquement début d'URL avec file:, ftp:, gopher:, ou http : en charge. ASSERTS si le pszURL est NULL.dwContext
Une valeur définie par l'application est passée avec le handle retourné dans le rappel.dwFlags
Les balises qui décrivent comment gérer cette connexion. Consultez Notes pour plus d'informations sur les indicateurs valides. Les indicateurs valides sont les suivantes :INTERNET_FLAG_TRANSFER_ASCII la valeur par défaut. Transférez le fichier en tant que texte ASCII.
Migration d'INTERNET_FLAG_TRANSFER_BINARY le fichier en tant que fichier binaire.
Obtention d'INTERNET_FLAG_RELOAD les données du thread même s'il est mis en cache localement.
INTERNET_FLAG_DONT_CACHE ne mettent en cache les données, localement ou dans une passerelle.
INTERNET_FLAG_SECURE cette balise s'applique aux requêtes HTTP uniquement. Il demande des transactions sécurisé sur le thread avec le protocole SSL ou le PCT.
INTERNET_OPEN_FLAG_USE_EXISTING_CONNECT si possible, réutilisent les connexions existantes vers le serveur pour les nouvelles demandes générées par OpenUrl au lieu de créer une nouvelle session pour chaque requête de connexion.
INTERNET_FLAG_PASSIVE celle utilisée pour un site FTP. Utilise la sémantique passive FTP. Utilisé avec CInternetConnection d' OpenURL.
pstrHeaders
Un pointeur vers une chaîne contenant les en-têtes à envoyer au serveur HTTP.dwHeadersLength
La longueur, en caractères, des en-têtes supplémentaires. Si c'est -1L et pstrHeaders estNULLnon, alors considéré comme pstrHeaders zéro est terminé et la longueur est calculée.
Valeur de retour
Retourne un handle de fichier pour le FTP, le GOPHER, le HTTP, et les services Internet de type de fichier uniquement. Retourne NULL si l'analyse est infructueux.
Le pointeur d' OpenURL retourne dépend du type des pszURLde service. Le tableau ci-dessous indique les pointeurs possible qu' OpenURL peut retourner.
Type URL |
Returns (Retours) |
|---|---|
file:// |
CStdioFile* |
http:// |
CHttpFile* |
gopher:// |
CGopherFile* |
ftp:// |
CInternetFile* |
Notes
Le paramètre dwFlags doit inclure INTERNET_FLAG_TRANSFER_ASCII ou INTERNET_FLAG_TRANSFER_BINARY, mais pas les deux. Les autres balises peuvent être combinées avec au niveau de le bit l'opérateur d' OR ( |).
OpenURL, qui encapsule la fonction InternetOpenURLWin32, permet uniquement télécharger, récupérer, puis lire les données d'un serveur Web. OpenURL ne permet pas de manipulation de fichier sur un emplacement distant, il ne requiert aucun objet de CInternetConnection .
Pour utiliser les fonctions de connexion- particulier (autrement dit, spécifique au fournisseur), telles que l'écriture dans un fichier, vous devez vous connecter, puis ouvrez un type particulier de connexion, puis d'utiliser cette connexion d'ouvrir un fichier en mode souhaité. Consultez l' CInternetConnection pour plus d'informations sur les fonctions de connexion- détail.
Exceptions
Cette méthode peut lever des exceptions de type CInternetException*.
Configuration requise
Header: afxinet.h