FtpOpenFileA 関数 (wininet.h)

読み取りまたは書き込みのために FTP サーバー上のリモート ファイルへのアクセスを開始します。

構文

HINTERNET FtpOpenFileA(
  [in] HINTERNET hConnect,
  [in] LPCSTR    lpszFileName,
  [in] DWORD     dwAccess,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwContext
);

パラメーター

[in] hConnect

FTP セッションへのハンドル。

[in] lpszFileName

アクセスするファイルの名前を含む null で終わる文字列へのポインター。

[in] dwAccess

ファイル アクセス。 このパラメーターは、GENERIC_READ または GENERIC_WRITEできますが、両方を指定することはできません。

[in] dwFlags

転送が発生する条件。 アプリケーションでは、1 つの転送の種類と、ファイルのキャッシュの制御方法を示すフラグのいずれかを選択する必要があります。

転送の種類には、次のいずれかの値を指定できます。

ファイルのキャッシュを制御するには、次の値を使用します。 アプリケーションでは、これらの値の 1 つ以上を使用できます。

[in] dwContext

この検索を任意のアプリケーション データに関連付けるアプリケーション定義値を含む変数へのポインター。 これは、アプリケーションが既に internetSetStatusCallback 呼び出して状態コールバック関数を設定している場合にのみ使用されます。

戻り値

成功した場合はハンドルを返し、それ以外の場合は NULL します。 特定のエラー メッセージを取得するには、GetLastError呼び出します。

備考

ftpOpenFile 呼び出した後、InternetCloseHandle呼び出すまで、同じ FTP セッション ハンドル上の FTP 関数に対する他のすべての呼び出しが失敗し、エラー メッセージが ERROR_FTP_TRANSFER_IN_PROGRESSに設定されます。 FtpOpenFileによって返される HINTERNET ハンドル の使用が完了したら、InternetCloseHandle 関数を使用して呼び出し元のアプリケーションを閉じる必要があります。

1 つの FTP セッションで開くことができるファイルは 1 つだけです。 そのため、ファイル ハンドルは返されません。アプリケーションは必要に応じて FTP セッション ハンドルを使用するだけです。

エラー 12058 は、使用可能なローカル ポートがないため に FtpOpenFileA が失敗した場合に発生する可能性があります。

lpszFileName パラメーターには、現在のディレクトリに対する部分的または完全修飾ファイル名を指定できます。

WinINet API の他のすべての側面と同様に、この関数は DllMain またはグローバル オブジェクトのコンストラクターとデストラクターから安全に呼び出すことはできません。

必要条件

関連項目

FTP セッション

WinINet Functions の