CInternetSession::GetFtpConnection
CFtpConnection のオブジェクトへの FTP 接続を確立でき、ポインターを取得するには、このメンバー関数を呼び出します。
CFtpConnection* GetFtpConnection(
LPCTSTR pstrServer,
LPCTSTR pstrUserName = NULL,
LPCTSTR pstrPassword = NULL,
INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
BOOL bPassive = FALSE
);
パラメーター
pstrServer
FTP サーバーの名前を含む文字列へのポインター。pstrUserName
ログインするユーザーの名前を指定する NULL で終わる文字列へのポインター。null、既定値が匿名の場合は。pstrPassword
ログインするときに使用するパスワードを指定する NULL で終わる文字列へのポインター。pstrPassword と pstrUserName の両方が nullの場合は、既定の匿名ユーザーのパスワードは電子メールの名前です。pstrPassword が null (または空の文字列) の場合は、pstrUserName は nullではありませんが、空白のパスワードが使用されます。次の表は pstrUserName と pstrPasswordの 4 とおりの設定の動作を示しています:pstrUserName
pstrPassword
FTP サーバーに送信されるユーザー名
FTP サーバーに送信されるパスワード
null または「「
null または「「
[匿名」
ユーザーの電子メール名
文字列以外のnull
null または「「
pstrUserName
" "
null 非null の文字列
[エラー]
[エラー]
文字列以外のnull
文字列以外のnull
pstrUserName
pstrPassword
nPort
サーバーで使用する TCP/IP ポートを識別する数。bPassive
この FTP のセッションに対してアクティブ モードとパッシブを指定します。**[真]**に設定すると、が INTERNET_FLAG_PASSIVE、Win32 API dwFlag を設定します。
戻り値
CFtpConnection オブジェクトへのポインター。呼び出しが失敗した場合、CInternetException のスローされたオブジェクトを調べることにより、エラーの原因を判断します。
解説
GetFtpConnection は CFTPConnection のオブジェクトに FTP サーバーに接続し、ポインターを作成し、を返します。つまり、サーバーの特定の操作を実行しません。読み取るするかまたはたとえば、ファイルに書き込むには、別の手順として、これらの操作を実行する必要があります。ファイル、ファイル、およびファイルの読み取りまたは書き込みを検索する方法の詳細については、クラス CFtpConnection と CFtpFileFind を参照してください。共通の FTP 接続のタスクを実行する手順については、" " WinInet するインターネットのプログラミング を参照してください。
例外
このメソッドは、型 **CInternetException***の例外をスローできます。
使用例
CFtpFileFindの例を参照してください。
必要条件
Header: afxinet.h
参照
関連項目
CInternetSession::GetGopherConnection