次の方法で共有

FtpCommandW 関数 (wininet.h)

  • [アーティクル]

FtpCommand 関数は、FTP サーバーにコマンドを直接送信します。

構文

BOOL FtpCommandW(
  [in]  HINTERNET hConnect,
  [in]  BOOL      fExpectResponse,
  [in]  DWORD     dwFlags,
  [in]  LPCWSTR   lpszCommand,
  [in]  DWORD_PTR dwContext,
  [out] HINTERNET *phFtpCommand
);

パラメーター

[in] hConnect

InternetConnectへの呼び出しから返されるハンドル。

[in] fExpectResponse

アプリケーションが FTP サーバーによってデータ接続を確立することを想定しているかどうかを示すブール値。 これは、データ接続が必要な場合は TRUE を に設定するか、それ以外の場合は FALSE する必要があります。

[in] dwFlags

次のいずれかの値に設定できるパラメーター。

価値 意味
FTP_TRANSFER_TYPE_ASCII
 FTP ASCII (タイプ A) 転送メソッドを使用してファイルを転送します。 コントロールと書式設定のデータは、ローカルの同等のデータに変換されます。
FTP_TRANSFER_TYPE_BINARY
 FTP イメージ (タイプ I) 転送方法を使用してファイルを転送します。 ファイルは変更なしで正確に転送されます。 これが既定の転送方法です。

[in] lpszCommand

FTP サーバーに送信するコマンドを含む文字列へのポインター。

[in] dwContext

コールバック操作でアプリケーション コンテキストを識別するために使用されるアプリケーション定義値を含む変数へのポインター。

[out] phFtpCommand

有効なデータ ソケットが開かれた場合に作成されるハンドルへのポインター。 phFtpCommand を入力するには、fExpectResponse パラメーター TRUE を に設定する必要があります。

戻り値

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

備考

GetLastError は、クライアント アプリケーションがオフラインの場合に ERROR_INTERNET_NO_DIRECT_ACCESS を返すことができます。 1 つ以上のパラメーターが無効な場合、GetLastError は ERROR_INVALID_PARAMETERを返します。

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

注意 WinINet では、サーバーの実装はサポートされていません。 また、サービスから使用しないでください。 サーバーの実装またはサービスの場合は、Microsoft Windows HTTP Services (WinHTTP)を使用します。
 

手記

wininet.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして FtpCommand を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー wininet.h
ライブラリ Wininet.lib
DLL Wininet.dll

関連項目

FTP セッション

WinINet Functions の