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 Services (WinHTTP)を使用します。

 

手記

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

必要条件

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

関連項目

FTP セッション

WinINet Functions の