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 (Type 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 サービス (WinHTTP) を使用します。
 

注意

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

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wininet.h
Library Wininet.lib
[DLL] Wininet.dll

こちらもご覧ください

FTP セッション

WinINet 関数