FtpGetCurrentDirectoryW

指定した FTP セッションのカレントディレクトリを取得する。(Unicode)

FtpGetCurrentDirectoryW hConnect, lpszCurrentDirectory, lpdwCurrentDirectory

hConnect : [intptr] FTP セッションへのハンドル。
lpszCurrentDirectory : [wstr] カレントディレクトリの絶対パスを受け取る null 終端文字列へのポインタ。
lpdwCurrentDirectory : [var] バッファの長さ (TCHAR 単位) を指定する変数へのポインタ。バッファの長さには終端 null 文字の領域を含めなければならない。MAX_PATH の長さがあればすべてのパスに十分である。関数が戻ると、変数にはバッファにコピーされた文字数が格納される。

(プラグイン / モジュール : wininet.dll)

解説

指定した FTP セッションのカレントディレクトリを取得する。(Unicode)

[戻り値]
成功した場合は TRUE を、失敗した場合は FALSE を返す。具体的なエラーメッセージを取得するには GetLastError
を呼び出す。

[備考]
lpszCurrentDirectory バッファが十分大きくない場合、lpdwCurrentDirectory
には完全なカレントディレクトリ名を取得するために必要なバイト数が返される。WinINet API の他のすべての側面と同様に、本関数は
DllMain やグローバルオブジェクトのコンストラクタ・デストラクタの中から安全に呼び出すことはできない。注意: WinINet
はサーバー実装をサポートしていない。さらに、サービスから使用すべきでもない。サーバー実装やサービスでは Microsoft Windows
HTTP Services (WinHTTP) を使用すること。
> [!NOTE] > wininet.h ヘッダーは FtpGetCurrentDirectory
をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に基づいて本関数の ANSI 版または Unicode
版を自動的に選択する。エンコーディング中立のエイリアスとエンコーディング中立でないコードを混在させると、コンパイルエラーや実行時エラーの原因となるミスマッチが発生する可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報