FtpGetFileA 関数 (wininet.h)
FTP サーバーからファイルを取得し、指定されたファイル名の下に格納し、プロセス内に新しいローカル ファイルを作成します。
構文
BOOL FtpGetFileA(
[in] HINTERNET hConnect,
[in] LPCSTR lpszRemoteFile,
[in] LPCSTR lpszNewFile,
[in] BOOL fFailIfExists,
[in] DWORD dwFlagsAndAttributes,
[in] DWORD dwFlags,
[in] DWORD_PTR dwContext
);
パラメーター
[in] hConnect
FTP セッションへのハンドル。
[in] lpszRemoteFile
取得するファイルの名前を含む null で終わる文字列へのポインター。
[in] lpszNewFile
ローカル システムに作成するファイルの名前を含む null で終わる文字列へのポインター。
[in] fFailIfExists
指定した名前のローカル ファイルが既に存在する場合に関数を続行するかどうかを示します。 fFailIfExists
[in] dwFlagsAndAttributes
新しいファイルのファイル属性。 このパラメーターには、CreateFile 関数で使用される FILE_ATTRIBUTE_* フラグの任意の組み合わせを指定できます。
[in] dwFlags
関数がファイルのダウンロードを処理する方法を制御します。 フラグ値の最初のセットは、転送が行われる条件を示します。 これらの転送型フラグは、キャッシュを制御する 2 番目のフラグ セットと組み合わせて使用できます。
アプリケーションは、これらの転送の種類の値のいずれかを選択できます。
次のフラグは、このファイルのキャッシュの実行方法を決定します。 次のフラグの任意の組み合わせを転送の種類のフラグと共に使用できます。
[in] dwContext
この検索を任意のアプリケーション データに関連付けるアプリケーション定義値を含む変数へのポインター。 これは、アプリケーションが既に internetSetStatusCallback
戻り値
成功した場合
備考
FtpGetFile は、FTP サーバーからファイルを読み取り、ローカルに格納することに関連するすべてのブックキーピングとオーバーヘッドを処理する高度なルーチンです。 ファイル データのみを取得する必要があるアプリケーション、またはファイル転送を厳密に制御する必要があるアプリケーションでは、
dwFlags パラメーターで FTP_TRANSFER_TYPE_ASCIIが指定されている場合、ファイル データの変換により、コントロールと書式設定の文字がローカルに変換されます。 既定の転送はバイナリ モードで、ファイルはサーバーに格納されているのと同じ形式でダウンロードされます。
lpszRemoteFile
WinINet API の他のすべての側面と同様に、この関数は DllMain またはグローバル オブジェクトのコンストラクターとデストラクターから安全に呼び出すことはできません。
手記
wininet.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして FtpGetFile を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | wininet.h |
ライブラリ | Wininet.lib |
DLL | Wininet.dll |
関連項目
WinINet Functions の