From da64fe5d567bdb0ec013a1756079a8e0e3241eaf Mon Sep 17 00:00:00 2001 From: Francois Gouget Date: Tue, 20 Feb 2007 15:52:01 +0100 Subject: [PATCH] wininet: Move a bunch of misplaced API documentation. --- dlls/wininet/ftp.c | 201 +++++++++++++++++++++++---------------------- 1 file changed, 101 insertions(+), 100 deletions(-) diff --git a/dlls/wininet/ftp.c b/dlls/wininet/ftp.c index ed49af8102c..0e09a51fdb9 100644 --- a/dlls/wininet/ftp.c +++ b/dlls/wininet/ftp.c @@ -175,16 +175,6 @@ BOOL WINAPI FtpPutFileA(HINTERNET hConnect, LPCSTR lpszLocalFile, return ret; } -/*********************************************************************** - * FtpPutFileW (WININET.@) - * - * Uploads a file to the FTP server - * - * RETURNS - * TRUE on success - * FALSE on failure - * - */ static void AsyncFtpPutFileProc(WORKREQUEST *workRequest) { struct WORKREQ_FTPPUTFILEW const *req = &workRequest->u.FtpPutFileW; @@ -199,6 +189,16 @@ static void AsyncFtpPutFileProc(WORKREQUEST *workRequest) HeapFree(GetProcessHeap(), 0, req->lpszNewRemoteFile); } +/*********************************************************************** + * FtpPutFileW (WININET.@) + * + * Uploads a file to the FTP server + * + * RETURNS + * TRUE on success + * FALSE on failure + * + */ BOOL WINAPI FtpPutFileW(HINTERNET hConnect, LPCWSTR lpszLocalFile, LPCWSTR lpszNewRemoteFile, DWORD dwFlags, DWORD dwContext) { @@ -355,16 +355,6 @@ BOOL WINAPI FtpSetCurrentDirectoryA(HINTERNET hConnect, LPCSTR lpszDirectory) } -/*********************************************************************** - * FtpSetCurrentDirectoryW (WININET.@) - * - * Change the working directory on the FTP server - * - * RETURNS - * TRUE on success - * FALSE on failure - * - */ static void AsyncFtpSetCurrentDirectoryProc(WORKREQUEST *workRequest) { struct WORKREQ_FTPSETCURRENTDIRECTORYW const *req = &workRequest->u.FtpSetCurrentDirectoryW; @@ -376,6 +366,16 @@ static void AsyncFtpSetCurrentDirectoryProc(WORKREQUEST *workRequest) HeapFree(GetProcessHeap(), 0, req->lpszDirectory); } +/*********************************************************************** + * FtpSetCurrentDirectoryW (WININET.@) + * + * Change the working directory on the FTP server + * + * RETURNS + * TRUE on success + * FALSE on failure + * + */ BOOL WINAPI FtpSetCurrentDirectoryW(HINTERNET hConnect, LPCWSTR lpszDirectory) { LPWININETFTPSESSIONW lpwfs = NULL; @@ -495,16 +495,6 @@ BOOL WINAPI FtpCreateDirectoryA(HINTERNET hConnect, LPCSTR lpszDirectory) } -/*********************************************************************** - * FtpCreateDirectoryW (WININET.@) - * - * Create new directory on the FTP server - * - * RETURNS - * TRUE on success - * FALSE on failure - * - */ static void AsyncFtpCreateDirectoryProc(WORKREQUEST *workRequest) { struct WORKREQ_FTPCREATEDIRECTORYW const *req = &workRequest->u.FtpCreateDirectoryW; @@ -516,6 +506,16 @@ static void AsyncFtpCreateDirectoryProc(WORKREQUEST *workRequest) HeapFree(GetProcessHeap(), 0, req->lpszDirectory); } +/*********************************************************************** + * FtpCreateDirectoryW (WININET.@) + * + * Create new directory on the FTP server + * + * RETURNS + * TRUE on success + * FALSE on failure + * + */ BOOL WINAPI FtpCreateDirectoryW(HINTERNET hConnect, LPCWSTR lpszDirectory) { LPWININETFTPSESSIONW lpwfs; @@ -643,16 +643,6 @@ HINTERNET WINAPI FtpFindFirstFileA(HINTERNET hConnect, } -/*********************************************************************** - * FtpFindFirstFileW (WININET.@) - * - * Search the specified directory - * - * RETURNS - * HINTERNET on success - * NULL on failure - * - */ static void AsyncFtpFindFirstFileProc(WORKREQUEST *workRequest) { struct WORKREQ_FTPFINDFIRSTFILEW const *req = &workRequest->u.FtpFindFirstFileW; @@ -665,6 +655,16 @@ static void AsyncFtpFindFirstFileProc(WORKREQUEST *workRequest) HeapFree(GetProcessHeap(), 0, req->lpszSearchFile); } +/*********************************************************************** + * FtpFindFirstFileW (WININET.@) + * + * Search the specified directory + * + * RETURNS + * HINTERNET on success + * NULL on failure + * + */ HINTERNET WINAPI FtpFindFirstFileW(HINTERNET hConnect, LPCWSTR lpszSearchFile, LPWIN32_FIND_DATAW lpFindFileData, DWORD dwFlags, DWORD dwContext) { @@ -833,16 +833,6 @@ BOOL WINAPI FtpGetCurrentDirectoryA(HINTERNET hFtpSession, LPSTR lpszCurrentDire } -/*********************************************************************** - * FtpGetCurrentDirectoryW (WININET.@) - * - * Retrieves the current directory - * - * RETURNS - * TRUE on success - * FALSE on failure - * - */ static void AsyncFtpGetCurrentDirectoryProc(WORKREQUEST *workRequest) { struct WORKREQ_FTPGETCURRENTDIRECTORYW const *req = &workRequest->u.FtpGetCurrentDirectoryW; @@ -853,6 +843,16 @@ static void AsyncFtpGetCurrentDirectoryProc(WORKREQUEST *workRequest) FTP_FtpGetCurrentDirectoryW(lpwfs, req->lpszDirectory, req->lpdwDirectory); } +/*********************************************************************** + * FtpGetCurrentDirectoryW (WININET.@) + * + * Retrieves the current directory + * + * RETURNS + * TRUE on success + * FALSE on failure + * + */ BOOL WINAPI FtpGetCurrentDirectoryW(HINTERNET hFtpSession, LPWSTR lpszCurrentDirectory, LPDWORD lpdwCurrentDirectory) { @@ -993,16 +993,6 @@ HINTERNET WINAPI FtpOpenFileA(HINTERNET hFtpSession, } -/*********************************************************************** - * FtpOpenFileW (WININET.@) - * - * Open a remote file for writing or reading - * - * RETURNS - * HINTERNET handle on success - * NULL on failure - * - */ static void AsyncFtpOpenFileProc(WORKREQUEST *workRequest) { struct WORKREQ_FTPOPENFILEW const *req = &workRequest->u.FtpOpenFileW; @@ -1015,6 +1005,16 @@ static void AsyncFtpOpenFileProc(WORKREQUEST *workRequest) HeapFree(GetProcessHeap(), 0, req->lpszFilename); } +/*********************************************************************** + * FtpOpenFileW (WININET.@) + * + * Open a remote file for writing or reading + * + * RETURNS + * HINTERNET handle on success + * NULL on failure + * + */ HINTERNET WINAPI FtpOpenFileW(HINTERNET hFtpSession, LPCWSTR lpszFileName, DWORD fdwAccess, DWORD dwFlags, DWORD dwContext) @@ -1198,16 +1198,6 @@ BOOL WINAPI FtpGetFileA(HINTERNET hInternet, LPCSTR lpszRemoteFile, LPCSTR lpszN } -/*********************************************************************** - * FtpGetFileW (WININET.@) - * - * Retrieve file from the FTP server - * - * RETURNS - * TRUE on success - * FALSE on failure - * - */ static void AsyncFtpGetFileProc(WORKREQUEST *workRequest) { struct WORKREQ_FTPGETFILEW const *req = &workRequest->u.FtpGetFileW; @@ -1222,6 +1212,17 @@ static void AsyncFtpGetFileProc(WORKREQUEST *workRequest) HeapFree(GetProcessHeap(), 0, req->lpszNewFile); } + +/*********************************************************************** + * FtpGetFileW (WININET.@) + * + * Retrieve file from the FTP server + * + * RETURNS + * TRUE on success + * FALSE on failure + * + */ BOOL WINAPI FtpGetFileW(HINTERNET hInternet, LPCWSTR lpszRemoteFile, LPCWSTR lpszNewFile, BOOL fFailIfExists, DWORD dwLocalFlagsAttribute, DWORD dwInternetFlags, DWORD dwContext) @@ -1402,16 +1403,6 @@ BOOL WINAPI FtpDeleteFileA(HINTERNET hFtpSession, LPCSTR lpszFileName) return ret; } -/*********************************************************************** - * FtpDeleteFileW (WININET.@) - * - * Delete a file on the ftp server - * - * RETURNS - * TRUE on success - * FALSE on failure - * - */ static void AsyncFtpDeleteFileProc(WORKREQUEST *workRequest) { struct WORKREQ_FTPDELETEFILEW const *req = &workRequest->u.FtpDeleteFileW; @@ -1423,6 +1414,16 @@ static void AsyncFtpDeleteFileProc(WORKREQUEST *workRequest) HeapFree(GetProcessHeap(), 0, req->lpszFilename); } +/*********************************************************************** + * FtpDeleteFileW (WININET.@) + * + * Delete a file on the ftp server + * + * RETURNS + * TRUE on success + * FALSE on failure + * + */ BOOL WINAPI FtpDeleteFileW(HINTERNET hFtpSession, LPCWSTR lpszFileName) { LPWININETFTPSESSIONW lpwfs; @@ -1541,16 +1542,6 @@ BOOL WINAPI FtpRemoveDirectoryA(HINTERNET hFtpSession, LPCSTR lpszDirectory) return ret; } -/*********************************************************************** - * FtpRemoveDirectoryW (WININET.@) - * - * Remove a directory on the ftp server - * - * RETURNS - * TRUE on success - * FALSE on failure - * - */ static void AsyncFtpRemoveDirectoryProc(WORKREQUEST *workRequest) { struct WORKREQ_FTPREMOVEDIRECTORYW const *req = &workRequest->u.FtpRemoveDirectoryW; @@ -1562,6 +1553,16 @@ static void AsyncFtpRemoveDirectoryProc(WORKREQUEST *workRequest) HeapFree(GetProcessHeap(), 0, req->lpszDirectory); } +/*********************************************************************** + * FtpRemoveDirectoryW (WININET.@) + * + * Remove a directory on the ftp server + * + * RETURNS + * TRUE on success + * FALSE on failure + * + */ BOOL WINAPI FtpRemoveDirectoryW(HINTERNET hFtpSession, LPCWSTR lpszDirectory) { LPWININETFTPSESSIONW lpwfs; @@ -1684,16 +1685,6 @@ BOOL WINAPI FtpRenameFileA(HINTERNET hFtpSession, LPCSTR lpszSrc, LPCSTR lpszDes return ret; } -/*********************************************************************** - * FtpRenameFileW (WININET.@) - * - * Rename a file on the ftp server - * - * RETURNS - * TRUE on success - * FALSE on failure - * - */ static void AsyncFtpRenameFileProc(WORKREQUEST *workRequest) { struct WORKREQ_FTPRENAMEFILEW const *req = &workRequest->u.FtpRenameFileW; @@ -1706,6 +1697,16 @@ static void AsyncFtpRenameFileProc(WORKREQUEST *workRequest) HeapFree(GetProcessHeap(), 0, req->lpszDestFile); } +/*********************************************************************** + * FtpRenameFileW (WININET.@) + * + * Rename a file on the ftp server + * + * RETURNS + * TRUE on success + * FALSE on failure + * + */ BOOL WINAPI FtpRenameFileW(HINTERNET hFtpSession, LPCWSTR lpszSrc, LPCWSTR lpszDest) { LPWININETFTPSESSIONW lpwfs;