次の方法で共有

CFtpConnection::GetFile

  • [アーティクル]

ファイルを FTP サーバーから取得し、ローカル コンピューターに格納するには、このメンバー関数を呼び出します。

BOOL GetFile(
   LPCTSTR pstrRemoteFile,
   LPCTSTR pstrLocalFile,
   BOOL bFailIfExists = TRUE,
   DWORD dwAttributes = FILE_ATTRIBUTE_NORMAL,
   DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY,
   DWORD_PTR dwContext = 1 
);

パラメーター

  • pstrRemoteFile
    FTP サーバーから取得するファイルの名前を含む null で終わる文字列へのポインター。

  • pstrLocalFile
    ローカル システムで作成するファイルの名前を含む null で終わる文字列へのポインター。

  • bFailIfExists
    ファイル名が既存のファイルで既に使用できるかどうかを示します。ローカル ファイル名が既に存在し、このパラメーターがの場合、[真]GetFile は失敗します。それ以外 GetFile はファイルの既存のコピーをオフにします。

  • dwAttributes
    ファイルの属性を示します。これは、次の FILE_ATTRIBUTE_* のフラグの組み合わせです。

    • FILE_ATTRIBUTE_ARCHIVE ファイルはアーカイブ ファイルです。アプリケーションは、ファイルにバックアップまたは削除のマークを付けるために、この属性を使います。

    • FILE_ATTRIBUTE_COMPRESSED は、ファイルまたはディレクトリ圧縮されます。ファイルには、圧縮ファイルのすべてのデータを圧縮することを意味します。ディレクトリの場合は、圧縮は、新しく作成されたファイルとサブディレクトリの既定値です。

    • FILE_ATTRIBUTE_DIRECTORY は、ファイル ディレクトリです。

    • FILE_ATTRIBUTE_NORMAL ファイルに他の属性は設定されていません。この属性は、単独で使用された場合だけ有効です。他のすべてのファイル属性に FILE_ATTRIBUTE_NORMAL をオーバーライドします:

    • FILE_ATTRIBUTE_HIDDEN ファイルは非表示になります。通常は、のディレクトリの一覧ではありません。

    • FILE_ATTRIBUTE_READONLY ファイルは読み取り専用です。アプリケーションがファイルを読み取ることができます。ファイルに書き込むか、削除できません。

    • FILE_ATTRIBUTE_SYSTEM ファイルが含まれており、オペレーティング システムによってのみ使用されます。

    • FILE_ATTRIBUTE_TEMPORARY は、一時的なストレージのファイルが使用されます。アプリケーションは、ファイルへの絶対に必要な場合にのみ作成する必要があります。ファイルのデータのほとんどはメモリにメディア ファイルへ洗い流されないのままですがすぐに削除されるため。

  • dwFlags
    コピーが発生する条件を指定します。このパラメーターがの Windows SDKの FtpGetFile で説明する dwFlags の値を指定できます。

  • dwContext
    ファイル検索のコンテキストの識別子。dwContextに関する詳細については、[コメント] を参照してください。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。呼び出しが失敗した場合、エラーの原因を判断するために、Win32 関数 GetLastError が呼び出されるかがあります。

解説

GetFile は、FTP サーバーからファイルを読み取り、ローカルに格納することに関連するオーバーヘッド高レベルをすべて処理ルーチンです。ファイル データのみを取得したり、ファイル転送のコントロールは終了を必要とするアプリケーションは、OpenFile と CInternetFile::Read を代わりに使用する必要があります。

dwFlags が、Windows と同じデータ ファイルへの変換 FILE_TRANSFER_TYPE_ASCII、コントロールの移動および書式指定文字の場合は。既定のコピーはサーバー上でファイルが格納されているのと同じ形式でダウンロードされたバイナリ モードです。

pstrRemoteFile と pstrLocalFile は、現在のディレクトリに対して相対的または完全修飾部分修飾ファイル名のいずれかです。円記号 (\) またはスラッシュは、いずれかの名前のディレクトリの区切り記号として (/) を使用できます。GetFile は、適切な文字に使用される前にディレクトリ名の区切りをに変換します。

任意の値にコンテキストの識別子を設定するに dwContext の既定値をオーバーライドします。コンテキストの識別子は CInternetSession のオブジェクトによって作成された CFtpConnection のオブジェクトの特定の操作に関連付けられます。値は CInternetSession::OnStatusCallback に識別される操作で状態を提供するために戻ります。コンテキストの識別子の詳細については、" " インターネットの対処方法: WinInet を参照してください。

必要条件

ヘッダー: afxinet.h

参照

関連項目

CFtpConnection クラス

階層図

CInternetConnection クラス