FtpGetCurrentDirectoryA 関数 (wininet.h)

  • [アーティクル]

指定した FTP セッションの現在のディレクトリを取得します。

構文

BOOL FtpGetCurrentDirectoryA(
  [in]      HINTERNET hConnect,
  [out]     LPSTR     lpszCurrentDirectory,
  [in, out] LPDWORD   lpdwCurrentDirectory
);

パラメーター

[in] hConnect

FTP セッションへの処理。

[out] lpszCurrentDirectory

現在のディレクトリの絶対パスを受け取る null で終わる文字列へのポインター。

[in, out] lpdwCurrentDirectory

バッファーの長さを TCHAR で指定する変数へのポインター。 バッファーの長さは、終端の null 文字用のスペースを含める必要があります。 すべてのパスには、 長さMAX_PATH を使用するだけで十分です。 関数が戻ると、変数はバッファーにコピーされた文字数を受け取ります。

戻り値

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

注釈

lpszCurrentDirectory バッファーのサイズが十分でない場合、lpdwCurrentDirectory は現在のディレクトリ名全体を取得するために必要なバイト数を受け取ります。

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

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

注意

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

要件

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

こちらもご覧ください

FTP セッション

FtpSetCurrentDirectory

WinINet 関数