FTP 会话

项目
03/11/2025

WinINet 使应用程序能够在 ftp 服务器上导航和作目录和文件。由于 CERN 代理不支持 FTP，因此仅使用 CERN 代理的应用程序必须使用 InternetOpenUrl 函数。有关如何使用 InternetOpenUrl的详细信息，请参阅直接访问 URL。

若要开始 FTP 会话，请使用 InternetConnect 来创建会话句柄。

使用 WinINet 可以在 FTP 服务器上执行以下作：

在目录之间导航。
枚举、创建、删除和重命名目录。
重命名、上传、下载和删除文件。

导航由 FtpGetCurrentDirectory 和 FtpSetCurrentDirectory 函数提供。这些函数利用先前调用 InternetConnect 创建的会话句柄来确定应用程序当前所在的目录，或更改为其他子目录。

目录枚举通过使用 FtpFindFirstFile 和 InternetFindNextFile 函数来执行。 FtpFindFirstFile 使用 InternetConnect 创建的会话句柄查找与给定搜索条件匹配的第一个文件，并返回一个句柄以继续目录枚举。 InternetFindNextFile 使用 FtpFindFirstFile 返回的句柄返回与原始搜索条件匹配的下一个文件。应用程序应继续调用 InternetFindNextFile，直到目录中没有剩余的文件。

使用 FtpCreateDirectory 函数创建新目录。此函数使用 InternetConnect 创建的会话句柄，并创建传递给函数的字符串指定的目录。字符串可以包含相对于当前目录的目录名称或完全限定的目录路径。

若要重命名文件或目录，应用程序可以调用 FtpRenameFile。此函数将原始名称替换为传递给函数的新名称。文件或目录的名称可以是相对于当前目录，也可以是完全限定的名称。

若要在 FTP 服务器上上传或放置文件，应用程序可以使用 FtpPutFile 或 FtpOpenFile（以及 InternetWriteFile）。如果文件已存在于本地，则可以使用 FtpPutFile，而当需要将数据写入 FTP 服务器上的文件时，可以使用 FtpOpenFile 和 InternetWriteFile。

若要下载或获取文件，应用程序可以使用 FtpGetFile 或 FtpOpenFile（InternetReadFile）。 FtpGetFile 用于从 FTP 服务器检索文件并将其存储在本地，而 FtpOpenFile 和 InternetReadFile 可用于控制下载的信息的运行位置（例如，应用程序可以在编辑框中显示信息）。

使用 FtpDeleteFile 函数删除 FTP 服务器上的文件。此函数从 FTP 服务器中删除相对于当前目录或完全限定文件名的文件名。 FtpDeleteFile 需要 InternetConnect返回的会话句柄。

FTP 函数句柄

若要正常工作，FTP 函数需要某些类型的 HINTERNET 句柄。这些句柄必须按特定顺序创建，从 InternetOpen创建的根句柄开始。然后，InternetConnect 可以创建 FTP 会话句柄。

下图显示了依赖于 InternetConnect返回的 FTP 会话句柄的函数。阴影框表示返回 HINTERNET 句柄的函数，而纯框表示使用由它们依赖的函数创建的 HINTERNET 句柄的函数。

依赖于 internetconnect 返回的 ftp 会话句柄的 ftp 函数

下图显示了返回 HINTERNET 句柄的两个函数以及依赖于它们的函数。阴影框表示返回 HINTERNET 句柄的函数，而纯框表示使用 HINTERNET 句柄创建的函数。

返回 hinternet 句柄的 ftp 函数

有关详细信息，请参阅 HINTERNET 句柄。

将 WinINet 函数用于 FTP 会话

FTP 会话期间使用以下函数。 CERN 代理无法识别这些函数。必须通过 CERN 代理运行的应用程序应使用 InternetOpenUrl 并直接访问资源。有关直接资源访问的详细信息，请参阅直接访问 URL。

功能	描述
FtpCreateDirectory	在服务器上创建新目录。此函数需要由 InternetConnect创建的句柄。
FtpDeleteFile	从服务器中删除文件。此函数需要由 InternetConnect创建的句柄。
FtpFindFirstFile	在当前目录中启动文件枚举或文件搜索。此函数需要由 InternetConnect创建的句柄。
FtpGetCurrentDirectory	返回服务器上的客户端当前目录。此函数需要由 InternetConnect创建的句柄。
FtpGetFile	从服务器检索文件。此函数需要由 InternetConnect创建的句柄。
FtpOpenFile	启动对服务器上的文件进行读取或写入的访问。此函数需要由 InternetConnect创建的句柄。
FtpPutFile	将文件写入服务器。此函数需要由 InternetConnect创建的句柄。
FtpRemoveDirectory	删除服务器上的目录。此函数需要由 InternetConnect创建的句柄。
FtpRenameFile	重命名服务器上的文件。此函数需要由 InternetConnect创建的句柄。
FtpSetCurrentDirectory	更改服务器上的客户端当前目录。此函数需要由 InternetConnect创建的句柄。
InternetWriteFile	将数据写入服务器上的打开的文件。此函数需要由 FtpOpenFile创建的句柄。

启动 FTP 会话

应用程序通过在 InternetOpen创建的句柄上调用 InternetConnect 来建立 FTP 会话。 InternetConnect 需要服务器名称、端口号、用户名、密码和服务类型（必须设置为INTERNET_SERVICE_FTP）。对于被动 FTP 语义，应用程序还必须设置 INTERNET_FLAG_PASSIVE 标志。

INTERNET_DEFAULT_FTP_PORT和INTERNET_INVALID_PORT_NUMBER值可用于端口号。 INTERNET_DEFAULT_FTP_PORT使用默认 FTP 端口，但仍必须设置服务类型。 INTERNET_INVALID_PORT_NUMBER使用指示的服务类型的默认值。

用户名和密码的值可以设置为 NULL。如果这两个值都设置为 NULL，则 InternetConnect 对用户名使用“匿名”，以及密码的用户电子邮件地址。如果仅将密码设置为 NULL，则传递给 InternetConnect 的用户名用于用户名，并将空字符串用于密码。如果两个值都不 NULL，则使用提供给 InternetConnect 的用户名和密码。

枚举目录

FTP 服务器上的目录枚举需要 FtpFindFirstFile创建句柄。此句柄是由 InternetConnect创建的会话句柄的分支。 FtpFindFirstFile 找到服务器上的第一个文件或目录，并在 WIN32_FIND_DATA 结构中返回它。使用 InternetFindNextFile，直到返回 ERROR_NO_MORE_FILES。此方法查找服务器上的所有后续文件和目录。有关 InternetFindNextFile的详细信息，请参阅查找下一个文件。

若要确定 FtpFindFirstFile 或 InternetFindNextFile 检索的文件是否为目录，请检查 dwFileAttributesWIN32_FIND_DATA 结构的成员，以查看该文件是否等于FILE_ATTRIBUTE_DIRECTORY。

如果应用程序在 FTP 服务器上进行更改，或者 FTP 服务器频繁更改，则应 在 ftpFindFirstFile中设置 INTERNET_FLAG_NO_CACHE_WRITE 和 INTERNET_FLAG_RELOAD 标志。这些标志可确保从 FTP 服务器检索到的目录信息是最新的。

应用程序完成目录枚举后，应用程序必须对 FtpFindFirstFile创建的句柄 InternetCloseHandle 进行调用。在关闭该句柄之前，应用程序无法对 InternetConnect创建的会话句柄再次调用 FtpFindFirstFile。如果在关闭对同一函数的上一次 调用之前在同一会话句柄上发出对 ftpFindFirstFile 的调用，该函数将失败，并返回 ERROR_FTP_TRANSFER_IN_PROGRESS。

以下示例将 FTP 目录的内容枚举到列表框控件中。 hConnection 参数是在建立 FTP 会话后由 InternetConnect 函数返回的句柄。此示例中引用的 InternetErrorOut 函数的示例源代码可在处理错误主题中找到。

#include <windows.h>
#include <strsafe.h>
#include <wininet.h>

#pragma comment(lib, "wininet.lib")
#pragma comment(lib, "user32.lib")

#define  FTP_FUNCTIONS_BUFFER_SIZE          MAX_PATH+8

BOOL WINAPI DisplayFtpDir(
                           HWND hDlg,
                           HINTERNET hConnection,
                           DWORD dwFindFlags,
                           int nListBoxId )
{
  WIN32_FIND_DATA dirInfo;
  HINTERNET       hFind;
  DWORD           dwError;
  BOOL            retVal = FALSE;
  TCHAR           szMsgBuffer[FTP_FUNCTIONS_BUFFER_SIZE];
  TCHAR           szFName[FTP_FUNCTIONS_BUFFER_SIZE];
  
  SendDlgItemMessage( hDlg, nListBoxId, LB_RESETCONTENT, 0, 0 );
  hFind = FtpFindFirstFile( hConnection, TEXT( "*.*" ), 
                            &dirInfo, dwFindFlags, 0 );
  if ( hFind == NULL )
  {
    dwError = GetLastError( );
    if( dwError == ERROR_NO_MORE_FILES )
    {
      StringCchCopy( szMsgBuffer, FTP_FUNCTIONS_BUFFER_SIZE,
        TEXT( "No files found at FTP location specified." ) );
      retVal = TRUE;
      goto DisplayDirError_1;
    }
    StringCchCopy( szMsgBuffer, FTP_FUNCTIONS_BUFFER_SIZE,
      TEXT( "FtpFindFirstFile failed." ) );
    goto DisplayDirError_1;
  }

  do
  {
    if( FAILED( StringCchCopy( szFName, FTP_FUNCTIONS_BUFFER_SIZE,
                  dirInfo.cFileName ) ) ||
        ( ( dirInfo.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY ) &&
        ( FAILED( StringCchCat( szFName, FTP_FUNCTIONS_BUFFER_SIZE,
         TEXT( " <DIR> " ) ) ) ) ) )
    {
      StringCchCopy( szMsgBuffer, FTP_FUNCTIONS_BUFFER_SIZE,
        TEXT( "Failed to copy a file or directory name." ) );
      retVal = FALSE;
      goto DisplayDirError_2;
    }
    SendDlgItemMessage( hDlg, nListBoxId, LB_ADDSTRING, 
                        0, (LPARAM) szFName );
  } while( InternetFindNextFile( hFind, (LPVOID) &dirInfo ) );

  if( ( dwError = GetLastError( ) ) == ERROR_NO_MORE_FILES )
  {
    InternetCloseHandle(hFind);
    return( TRUE );
  }
  StringCchCopy( szMsgBuffer, FTP_FUNCTIONS_BUFFER_SIZE,
    TEXT( "FtpFindNextFile failed." ) );

DisplayDirError_2:
  InternetCloseHandle( hFind );
DisplayDirError_1:
  MessageBox( hDlg,
    (LPCTSTR) szMsgBuffer,
    TEXT( "DisplayFtpDir( ) Problem" ),
    MB_OK | MB_ICONERROR );
  return( retVal );
}

导航目录

FtpGetCurrentDirectory 和 FtpSetCurrentDirectory 函数处理目录导航。

FtpGetCurrentDirectory 在 FTP 服务器上返回应用程序的当前目录。包含来自 FTP 服务器上的根目录的目录路径。

FtpSetCurrentDirectory 更改服务器上的工作目录。传递给 FtpSetCurrentDirectory 的目录信息可以是相对于当前目录的部分或完全限定的路径名称。例如，如果应用程序当前位于目录“public/info”中，并且路径为“ftp/example”，FtpSetCurrentDirectory 将当前目录更改为“public/info/ftp/example”。

以下示例使用 ftp 会话句柄 hConnection，InternetConnect返回。新目录名称取自父对话框的编辑框，该对话框的 IDC 在 nDirNameId 参数中传递。在更改目录之前，该函数将检索当前目录并将其存储在同一编辑框中。上面列出了在末尾调用的 DisplayFtpDir 函数的 souce 代码。

BOOL WINAPI ChangeFtpDir( HWND hDlg, 
                          HINTERNET hConnection,
                          int nDirNameId, 
                          int nListBoxId )
{
  DWORD dwSize;
  TCHAR szNewDirName[FTP_FUNCTIONS_BUFFER_SIZE];
  TCHAR szOldDirName[FTP_FUNCTIONS_BUFFER_SIZE];
  TCHAR* szFailedFunctionName;

  dwSize = FTP_FUNCTIONS_BUFFER_SIZE;

  if( !GetDlgItemText( hDlg, nDirNameId, szNewDirName, dwSize ) )
  {
    szFailedFunctionName = TEXT( "GetDlgItemText" );
    goto ChangeFtpDirError;
  }

  if ( !FtpGetCurrentDirectory( hConnection, szOldDirName, &dwSize ))
  {
    szFailedFunctionName = TEXT( "FtpGetCurrentDirectory" );
    goto ChangeFtpDirError;
  }

  if( !SetDlgItemText( hDlg, nDirNameId, szOldDirName ) )
  {
    szFailedFunctionName = TEXT( "SetDlgItemText" );
    goto ChangeFtpDirError;
  }

  if( !FtpSetCurrentDirectory( hConnection, szNewDirName ) )
  {
    szFailedFunctionName = TEXT( "FtpSetCurrentDirectory" );
    goto ChangeFtpDirError;
  }
  return( DisplayFtpDir( hDlg, hConnection, 0, nListBoxId ) );

ChangeFtpDirError:
  InternetErrorOut( hDlg, GetLastError( ), szFailedFunctionName );
  DisplayFtpDir( hDlg, hConnection, INTERNET_FLAG_RELOAD, nListBoxId);
  return( FALSE );
}

作 FTP 服务器上的目录

WinINet 提供在应用程序具有必要权限的 FTP 服务器上创建和删除目录的功能。如果应用程序必须登录到具有特定用户名和密码的服务器，则创建 FTP 会话句柄时，这些值可以在 InternetConnect 中使用。

FtpCreateDirectory 函数采用有效的 FTP 会话句柄和 null终止字符串，该字符串包含完全限定的路径或相对于当前目录的名称，并在 FTP 服务器上创建目录。

以下示例演示了两个单独的 FtpCreateDirectory调用。在这两个示例中，hFtpSession 是由 InternetConnect 函数创建的会话句柄，根目录是当前目录。

/* Creates the directory "test" in the current (root) directory. */
FtpCreateDirectory( hFtpSession, "test" );

/* Creates the directory "example" in the test directory. */
FtpCreateDirectory( hFtpSession, "\\test\\example" );

FtpRemoveDirectory 函数采用会话句柄和 null终止字符串，该字符串包含完全限定的路径或相对于当前目录的名称，并从 FTP 服务器中删除该目录。

以下示例演示了对 ftpRemoveDirectory的两个示例调用。在这两个调用中，hFtpSession 是由 InternetConnect 函数创建的会话句柄，根目录是当前目录。根目录中有一个名为“test”的目录，在“test”目录中有一个名为“example”的目录。

/* Removes the "example" directory (plus any files/directories it contains) from the "test" directory. */
FtpRemoveDirectory(hFtpSession,"\\test\\example");

/* Removes the "test" directory (plus any files/directories it contains) from the root directory. */
FtpRemoveDirectory(hFtpSession, "test");

FtpRemoveDirectory(hFtpSession,TEXT("\\test\\example"));
/* Removes the "example" directory and any files or 
directories contained in it from the "test" directory. */

FtpRemoveDirectory(hFtpSession, TEXT("test"));
/* Removes the "test" directory and any files or 
directories contained in it from the root directory. */

以下示例在 FTP 服务器上创建新目录。新目录名称取自父对话框的编辑框，该对话框的 IDC 在 nDirNameId 参数中传递。 hConnection 句柄是在建立 FTP 会话后由 InternetConnect 创建的。上面列出了在末尾调用的 DisplayFtpDir 函数的源代码。

BOOL WINAPI CreateFtpDir( HWND hDlg, HINTERNET hConnection,
                          int nDirNameId, int nListBoxId )
{
  TCHAR szNewDirName[FTP_FUNCTIONS_BUFFER_SIZE];

  if( !GetDlgItemText( hDlg, nDirNameId, 
                       szNewDirName, 
                       FTP_FUNCTIONS_BUFFER_SIZE ) )
  {
    MessageBox( hDlg, 
                TEXT( "Error: Directory Name Must Be Specified" ),
                TEXT( "Create FTP Directory" ), 
                MB_OK | MB_ICONERROR );
    return( FALSE );
  }

  if( !FtpCreateDirectory( hConnection, szNewDirName ) )
  {
    InternetErrorOut( hDlg, GetLastError( ), 
                      TEXT( "FtpCreateDirectory" ) );
    return( FALSE );
  }

  return( DisplayFtpDir( hDlg, hConnection, 
                         INTERNET_FLAG_RELOAD, 
                         nListBoxId ) );
}

以下示例从 FTP 服务器中删除目录。要删除的目录的名称取自父对话框中的编辑框，其 IDC 将传递到 nDirNameId 参数中。 hConnection 句柄是在建立 FTP 会话后由 InternetConnect 创建的。上面列出了在末尾调用的 DisplayFtpDir 函数的源代码。

BOOL WINAPI RemoveFtpDir( HWND hDlg, HINTERNET hConnection,
                          int nDirNameId, int nListBoxId )
{
  TCHAR szDelDirName[FTP_FUNCTIONS_BUFFER_SIZE];

  if( !GetDlgItemText( hDlg, nDirNameId, szDelDirName, 
                       FTP_FUNCTIONS_BUFFER_SIZE ) )
  {
    MessageBox( hDlg, 
                TEXT( "Error: Directory Name Must Be Specified" ),
                TEXT( "Remove FTP Directory" ), 
                MB_OK | MB_ICONERROR );
    return( FALSE );
  }

  if( !FtpRemoveDirectory( hConnection, szDelDirName ) )
  {
    InternetErrorOut( hDlg, GetLastError( ), 
                      TEXT( "FtpRemoveDirectory" ) );
    return( FALSE );
  }

  return( DisplayFtpDir( hDlg, hConnection, 
                         INTERNET_FLAG_RELOAD, nListBoxId ) );
}

获取 FTP 服务器上的文件

有三种方法可用于从 FTP 服务器检索文件：

使用 InternetOpenUrl，InternetReadFile。
使用 FtpOpenFile 和 InternetReadFile。
使用 FtpGetFile。

有关使用 InternetReadFile 函数的详细信息，请参阅读取文件。

如果文件的 URL 可用，应用程序可以调用 InternetOpenUrl 连接到该 URL，然后使用 InternetReadFile 来控制文件的下载。这样，应用程序就可以更严格地控制下载，非常适合不需要在 FTP 服务器上执行其他作的情况。有关如何直接访问资源的详细信息，请参阅直接访问 URL。

如果应用程序已使用 InternetConnect与服务器建立了 FTP 会话句柄，则应用程序可以使用现有文件名和本地存储文件的新名称调用 FtpOpenFile。然后，应用程序可以使用 InternetReadFile 下载文件。这样，应用程序就可以更严格地控制下载，并保持与 FTP 服务器的连接，因此可以执行更多命令。

如果应用程序不需要严格控制下载，则应用程序可以使用 FTP 会话句柄、远程文件名和本地文件名 FtpGetFile 来检索文件。 FtpGetFile 执行与从 FTP 服务器读取文件并在本地存储文件相关的所有记帐和开销。

以下示例从 FTP 服务器检索文件并将其保存在本地。 FTP 服务器上的文件名称取自父对话框中的编辑框，其 IDC 在 nFtpFileNameId 参数中传递，并从 IDC 传入 nLocalFileNameId 参数的编辑框中获取文件的本地名称。 hConnection 句柄是在建立 FTP 会话后由 InternetConnect 创建的。

BOOL WINAPI GetFtpFile( HWND hDlg, HINTERNET hConnection,
                        int nFtpFileNameId, int nLocalFileNameId )
{
  TCHAR szFtpFileName[FTP_FUNCTIONS_BUFFER_SIZE];
  TCHAR szLocalFileName[FTP_FUNCTIONS_BUFFER_SIZE];
  DWORD dwTransferType;
  TCHAR szBoxTitle[] = TEXT( "Download FTP File" );
  TCHAR szAsciiQuery[] =
    TEXT("Do you want to download as ASCII text?(Default is binary)");
  TCHAR szAsciiDone[] = 
    TEXT( "ASCII Transfer completed successfully..." );
  TCHAR szBinaryDone[] = 
    TEXT( "Binary Transfer completed successfully..." );

  if( !GetDlgItemText( hDlg, nFtpFileNameId, szFtpFileName,
                       FTP_FUNCTIONS_BUFFER_SIZE ) ||
      !GetDlgItemText( hDlg, nLocalFileNameId, szLocalFileName,
                       FTP_FUNCTIONS_BUFFER_SIZE ) )
  {
    MessageBox( hDlg, 
                TEXT( "Target File or Destination File Missing" ),
                szBoxTitle, 
                MB_OK | MB_ICONERROR );
    return( FALSE );
  }

  dwTransferType = ( MessageBox( hDlg, 
                                 szAsciiQuery, 
                                 szBoxTitle, 
                                 MB_YESNO ) == IDYES ) ?
                   FTP_TRANSFER_TYPE_ASCII : FTP_TRANSFER_TYPE_BINARY;
  dwTransferType |= INTERNET_FLAG_RELOAD;

  if( !FtpGetFile( hConnection, szFtpFileName, szLocalFileName, FALSE,
                   FILE_ATTRIBUTE_NORMAL, dwTransferType, 0 ) )
  {
    InternetErrorOut( hDlg, GetLastError( ), TEXT( "FtpGetFile" ) );
    return( FALSE );
  }

  MessageBox( hDlg,( dwTransferType == 
                      (FTP_TRANSFER_TYPE_ASCII | INTERNET_FLAG_RELOAD)) ?
                      szAsciiDone : szBinaryDone, szBoxTitle, MB_OK );
  return( TRUE );
}

将文件放置在 FTP 服务器上

在 FTP 服务器上放置文件有两种方法：

将 FtpOpenFile 与 InternetWriteFile配合使用。
使用 FtpPutFile。

必须将数据发送到 FTP 服务器但不包含包含所有数据的本地文件的应用程序应使用 FtpOpenFile 在 ftp 服务器上创建和打开文件。然后，应用程序可以使用 InternetWriteFile 将信息上传到文件。

如果文件已存在于本地，则应用程序可以使用 FtpPutFile 将文件上传到 FTP 服务器。 FtpPutFile 执行将本地文件上传到远程 FTP 服务器时的所有开销。

以下示例将本地文件复制到 FTP 服务器上。文件的本地名称取自父对话框中的编辑框，其 IDC 在 nLocalFileNameId 参数中传递，并从 IDC 在 nFtpFileNameId 参数中传递的编辑框中获取文件保存在 FTP 服务器上的名称。 hConnection 句柄是在建立 FTP 会话后由 InternetConnect 创建的。

BOOL WINAPI PutFtpFile( HWND hDlg, HINTERNET hConnection,
                        int nFtpFileNameId, int nLocalFileNameId )
{
  TCHAR szFtpFileName[FTP_FUNCTIONS_BUFFER_SIZE];
  TCHAR szLocalFileName[FTP_FUNCTIONS_BUFFER_SIZE];
  DWORD dwTransferType;
  TCHAR szBoxTitle[] = TEXT( "Upload FTP File" );
  TCHAR szASCIIQuery[] =
    TEXT("Do you want to upload as ASCII text? (Default is binary)");
  TCHAR szAsciiDone[] = 
    TEXT( "ASCII Transfer completed successfully..." );
  TCHAR szBinaryDone[] = 
    TEXT( "Binary Transfer completed successfully..." );

  if( !GetDlgItemText( hDlg, nFtpFileNameId, szFtpFileName,
                       FTP_FUNCTIONS_BUFFER_SIZE ) ||
      !GetDlgItemText( hDlg, nLocalFileNameId, szLocalFileName,
                       FTP_FUNCTIONS_BUFFER_SIZE ) )
  {
    MessageBox( hDlg, 
                TEXT("Target File or Destination File Missing"),
                szBoxTitle, 
                MB_OK | MB_ICONERROR );
    return( FALSE );
  }

  dwTransferType =
    ( MessageBox( hDlg, 
                  szASCIIQuery, 
                  szBoxTitle, 
                  MB_YESNO ) == IDYES ) ?
    FTP_TRANSFER_TYPE_ASCII : FTP_TRANSFER_TYPE_BINARY;

  if( !FtpPutFile( hConnection, 
                   szLocalFileName, 
                   szFtpFileName, 
                   dwTransferType, 
                   0 ) )
  {
    InternetErrorOut( hDlg, GetLastError( ), TEXT( "FtpGetFile" ) );
    return( FALSE );
  }

  MessageBox( hDlg,
              ( dwTransferType == FTP_TRANSFER_TYPE_ASCII ) ?
                szAsciiDone : szBinaryDone, szBoxTitle, MB_OK );
  return( TRUE );  // Remember to refresh directory listing
}

从 FTP 服务器中删除文件

若要从 FTP 服务器中删除文件，请使用 FtpDeleteFile 函数。调用应用程序必须具有从 FTP 服务器中删除文件所需的权限。

以下示例从 FTP 服务器中删除文件。要删除的文件的名称取自父对话框中的编辑框，其 IDC 将传入 nFtpFileNameId 参数。 hConnection 句柄是在建立 FTP 会话后由 InternetConnect 创建的。由于此函数不会刷新文件列表或目录显示，因此调用过程应在成功删除后执行此作。

BOOL WINAPI DeleteFtpFile( HWND hDlg, HINTERNET hConnection,
                           int nFtpFileNameId )
{
  TCHAR szFtpFileName[FTP_FUNCTIONS_BUFFER_SIZE];
  TCHAR szBoxTitle[] = TEXT( "Delete FTP File" );

  if( !GetDlgItemText( hDlg, nFtpFileNameId, szFtpFileName,
                       FTP_FUNCTIONS_BUFFER_SIZE ) )
  {
    MessageBox( hDlg, TEXT( "File Name Must Be Specified!" ),
                szBoxTitle, MB_OK | MB_ICONERROR );
    return( FALSE );
  }

  if( !FtpDeleteFile( hConnection, szFtpFileName ) )
  {
    InternetErrorOut( hDlg, 
                      GetLastError( ), 
                      TEXT( "FtpDeleteFile" ) );
    return( FALSE );
  }

  MessageBox( hDlg, 
              TEXT( "File has been deleted" ), 
              szBoxTitle, 
              MB_OK );
  return( TRUE );  // Remember to refresh directory listing
}

重命名 FTP 服务器上的文件和目录

可以使用 FtpRenameFile 函数重命名 FTP 服务器上的文件和目录。 FtpRenameFile 接受两个 null终止字符串，这些字符串包含相对于当前目录的部分或完全限定的名称。该函数将第一个字符串指定的文件的名称更改为第二个字符串指定的名称。

以下示例重命名 FTP 服务器上的文件或目录。文件的当前名称或目录取自父对话框中的编辑框，其 IDC 在 nOldFileNameId 参数中传递，而新名称取自 IDC 在 nNewFileNameId 参数中传递的编辑框。 hConnection 句柄是在建立 FTP 会话后由 InternetConnect 创建的。由于此函数不会刷新文件列表或目录显示，因此调用过程应在成功重命名后执行此作。

BOOL WINAPI RenameFtpFile( HWND hDlg, HINTERNET hConnection,
                           int nOldFileNameId, int nNewFileNameId )
{
  TCHAR szOldFileName[FTP_FUNCTIONS_BUFFER_SIZE];
  TCHAR szNewFileName[FTP_FUNCTIONS_BUFFER_SIZE];
  TCHAR szBoxTitle[] = TEXT( "Rename FTP File" );

  if( !GetDlgItemText( hDlg, nOldFileNameId, szOldFileName,
                       FTP_FUNCTIONS_BUFFER_SIZE ) ||
      !GetDlgItemText( hDlg, nNewFileNameId, szNewFileName,
                       FTP_FUNCTIONS_BUFFER_SIZE ) )
  {
    MessageBox( hDlg,
        TEXT( "Both the current and new file names must be supplied" ),
        szBoxTitle, 
        MB_OK | MB_ICONERROR );
    return( FALSE );
  }

  if( !FtpRenameFile( hConnection, szOldFileName, szNewFileName ) )
  {
    MessageBox( hDlg,
        TEXT( "FtpRenameFile failed" ),
        szBoxTitle, 
        MB_OK | MB_ICONERROR );
    return( FALSE );
  }
  return( TRUE );  // Remember to refresh directory listing
}

注意

WinINet 不支持服务器实现。此外，不应从服务使用它。对于服务器实现或服务，请使用 Microsoft Windows HTTP 服务（WinHTTP）。

通过