CFtpConnection::OpenFile

CInternetFile * OpenFile (LPCTSTR pstrFileName, DWORD dwAccess = GENERIC_READ, DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY, DWORD dwContext = 1);

Valeur de retour

Un pointeur vers un objet CInternetFile.

Paramètres

pstrFileName

Un pointeur vers une chaîne contenant le nom du fichier à ouvrir.

dwAccess

Détermine la façon dont le fichier sera accessible. Peut être GENERIC_READ ou GENERIC_WRITE, mais pas les deux.

dwFlags

Spécifie les conditions dans lesquelles se produisent les transferts subséquents. Cela peut être l'une des constantes FTP_TRANSFER_ *:

• FTP_TRA&NSFER_TYPE_ASCIInbsp ;  Le fichier transfère à l'aide de la méthode de transfert FTP ASCII (Type A). Convertit de contrôle et de mise en forme des informations à leurs équivalents des.
  
  
• FTP_TRA&NSFER_TYPE_BINARYnbsp ;  Le fichier transfère les données à l'aide de FTP Image (Type I) transfert de méthode. Les données de transferts de fichiers exactement telle qu'elle existent, sans changement. Il s'agit de la méthode de transfert par défaut.

dwContext

L'identificateur de contexte pour l'ouverture du fichier. Voir les remarques pour plus d'informations sur dwContext.

Remarques

Appelez cette fonction membre pour ouvrir un fichier situé sur un serveur FTP pour lire ou écrire. OpenFile doit être utilisé dans les situations suivantes:

• Une application a des données qui doit être envoyé et créé un fichier sur le serveur FTP, mais que les données ne sont pas dans un fichier local. Une fois OpenFile ouvre un fichier, l'application utilise CInternetFile::Write pour envoyer les données du fichier FTP au serveur.
  
  
• Une application doit extraire un fichier du serveur et placez-le dans la mémoire contrôlée par l'application, au lieu d'écrire sur le disque. L'application utilise CInternetFile::Read après l'utilisation de OpenFile pour ouvrir le fichier.
  
  
• Une application a besoin d'un beau niveau de contrôle sur un transfert de fichier. Par exemple, l'application peut souhaitez afficher une progression contrôle indiquent l'évolution de la situation de transfert de fichier lors du téléchargement d'un fichier.

Après avoir appelé OpenFile et jusqu'à appeler Close, l'application peut uniquement appeler CInternetFile::Read, CInternetFile::Write, étroiteou CFtpFileFind::FindFile. Les appels à d'autres fonctions FTP pour la même session FTP échoue et la valeur du code d'erreur FTP_ETRANSFER_IN_PROGRESS.

Le paramètre pstrFileName peut être soit un nom de fichier partiellement qualifié par rapport au répertoire actif ou pleinement qualifiés. Une barre oblique inverse (\) ou une barre oblique (/) peut être utilisé comme séparateur pour chaque nom de répertoire. OpenFile traduit les séparateurs de nom de répertoire des personnages approprié avant de l'utiliser.

Substituer la valeur par défaut de dwContext pour définir l'identificateur de contexte pour une valeur de votre choix. L'identificateur de contexte est associé à cette opération spécifique de l'objet CFtpConnection créé par son objet CInternetSession . La valeur est retournée au CInternetSession::OnStatusCallback d'État sur l'opération à laquelle il est identifié. Consultez l'article premiers pas Internet : WinInet pour plus d'informations sur l'identificateur de contexte.

Aperçu CFtpConnection |nbsp ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CInternetConnection, CFtpConnection::GetFile, CGopherConnection::OpenFile, CInternetFile::Write, CInternetFile::Read