Partager via


CFtpConnection::PutFile

Appelez la fonction membre pour stocker un fichier sur un serveur FTP.

BOOL PutFile( 
   LPCTSTR pstrLocalFile, 
   LPCTSTR pstrRemoteFile, 
   DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY, 
   DWORD_PTR dwContext = 1  
);

Paramètres

  • pstrLocalFile
    Un pointeur vers une chaîne contenant le nom du fichier d'envoyer du système local.

  • pstrRemoteFile
    Un pointeur vers une chaîne contenant le nom du fichier à créer sur le serveur FTP.

  • dwFlags
    Spécifie les conditions dans lesquelles le transfert du fichier se produit. Peuvent être des constantes l'une des FTP_TRANSFER_* décrites dans OpenFile.

  • dwContext
    L'identificateur de contexte pour définir le fichier. Consultez Notes pour plus d'informations sur dwContext.

Valeur de retour

Une valeur différente de zéro si l'opération a réussi ; sinon 0. Si l'appel échoue, la fonction GetLastError Win32 peut être appelée pour déterminer la cause de l'erreur.

Notes

PutFile est une routine de niveau supérieur qui effectue toutes les opérations associées à enregistrer un fichier sur un serveur FTP. Les applications qui envoient uniquement les données, ou qui requièrent un contrôle plus strict de transfert de fichiers, doivent utiliser OpenFile et CInternetFile::Write.

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' CFtpConnection 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.

Configuration requise

Header: afxinet.h

Voir aussi

Référence

CFtpConnection, classe

Graphique de la hiérarchie

CInternetConnection, classe