CInternetSession::OpenURL

CStdioFile * OpenURL (LPCTSTR pstrURL, DWORD dwContext = 1, DWORD dwFlags = INTERNET_FLAG_TRANSFER_ASCII, type LPCTSTR pstrHeaders = NULL, DWORD dwHeadersLength = 0 );
Jeter (CInternetException);

Valeur de retour

Retourne un handle de fichier pour les services Internet de type de fichier, HTTP, FTP et GOPHER seulement. Retourne NULL si l'analyse n'a pas réussi.

Le pointeur retourne OpenURL dépend pszURLdu type de service. Le tableau ci-dessous illustre les pointeurs possibles Qu'openurl peut retourner.

Paramètres

pstrURL

Pointeur vers le nom de l'URL pour commencer la lecture. Uniquement les URL commençant par fichier:, ftp:, gopher:, ou http: sont pris en charge. Affirme si pszURL est NULL.

dwContext

Une valeur définie par l'application est passée avec le handle retourné en rappel.

dwFlags

Les indicateurs décrivant comment gérer cette connexion. Pour plus d'informations sur les indicateurs valides, voir remarques . Les indicateurs valides sont:

• I&NTERNET_FLAG_TRANSFER_ASCIInbsp ;  La valeur par défaut. Transférer le fichier sous forme de texte ASCII.
  
  
• I&NTERNET_FLAG_TRANSFER_BINARYnbsp ;  Transférer le fichier comme un fichier binaire.
  
  
• I&NTERNET_FLAG_RELOADnbsp ;  Obtenir les données de la fil, même si elle est localement mise en cache.
  
  
• I&NTERNET_FLAG_DONT_CACHEnbsp ;  Pas en cache les données, soit localement soit dans les passerelles.
  
  
• I&NTERNET_FLAG_SECUREnbsp ;  Cet indicateur est applicable pour les demandes HTTP uniquement. Il demande des transactions sécurisées sur le fil avec Secure Sockets Layer ou PCT.
  
  
• I&NTERNET_OPEN_FLAG_USE_EXISTING_CONNECTnbsp ;  Si possible, réutiliser les connexions existantes sur le serveur pour les nouvelles demandes générées par OpenUrl au lieu de créer une nouvelle session pour chaque demande de connexion.
  
  
• I&NTERNET_FLAG_PASSIVEnbsp ;  Utilisé pour un site FTP. Utilise la sémantique FTP passif. Utilisé avec CInternetConnection d'OpenURL.

pstrHeaders

Un pointeur vers une chaîne contenant les en-têtes doit être envoyé au serveur HTTP.

dwHeadersLength

La longueur, en caractères, des en-têtes supplémentaires. Si c'est L-1 et pstrHeaders est non -NULL, alors pstrHeaders est supposé pour être zéro pris fin et la longueur est calculée.

Remarques

Appeler ce membre fo&nction pour envoyer la demande spécifiée pour le serveur HTTP et de permettre au client de spécifier d'autres RFC822, MIME, ou en-têtes HTTP à envoyer avec le request.nbsp;

Le paramètre dwFlags doit inclure INTERNET_FLAG_TRANSFER_ASCII ou INTERNET_FLAG_TRANSFER_BINARY, mais pas les deux. Les indicateurs restants peuvent être combinés avec l'opérateur de bits OR (|).

OpenURL, qui encapsule la fonction Win32 InternetOpenURL, permet seulement télécharger, extraire et lire les données d'un serveur Internet. OpenURL permet sans manipulation de fichier à un emplacement distant, donc elle n'exige aucun objet CInternetConnection.

D'utilisation spécifique à la connexion (c'est spécifique au protocole) fonctions, telles que l'écriture dans un fichier, vous devez ouvrir une session, puis ouvrez un type particulier de connexion, puis utilisez ce lien pour ouvrir un fichier dans le mode souhaité. Voir CInternetConnection pour plus d'informations sur les fonctions spécifiques à la connexion.

CInternetSession aperçu |nbsp ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CInternetConnection, CGopherConnection, CInternetSession::GetFtpConnection, CInternetSession::GetHttpConnection