FtpSetCurrentDirectoryA 関数 (wininet.h)

  • [アーティクル]

FTP サーバー上の別の作業ディレクトリに対する変更。

構文

BOOL FtpSetCurrentDirectoryA(
  [in] HINTERNET hConnect,
  [in] LPCSTR    lpszDirectory
);

パラメーター

[in] hConnect

FTP セッションへの処理。

[in] lpszDirectory

現在の作業ディレクトリになるディレクトリの名前を含む null で終わる文字列へのポインター。 これは、完全修飾パスまたは現在のディレクトリに対する相対名のいずれかです。

戻り値

成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。 特定のエラー メッセージを取得するには、 GetLastError を呼び出します。 FTP サーバーがディレクトリの変更要求を拒否したことを示すエラー メッセージが表示された場合は、 InternetGetLastResponseInfo を使用して理由を特定します。

解説

アプリケーションでは、リモート システムがディレクトリに階層型の名前付けスキームを使用していると想定するのではなく、 FtpGetCurrentDirectory を使用してリモート サイトの現在の作業ディレクトリを決定する必要があります。

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

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

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

Note

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

要件

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

関連項目

FTP セッション

WinINet 関数