James Hawkins : advpack: Add documentation for ExtractFiles.

[Alexandre Julliard]

Module: wine
Branch: refs/heads/master
Commit: 325c19cfc5a91918b41b86e310d5aae6905a983e
URL:    http://source.winehq.org/git/?p=wine.git;a=commit;h=325c19cfc5a91918b41b86e3...

Author: James Hawkins 
Date:   Mon Jan  9 20:26:10 2006 +0100

advpack: Add documentation for ExtractFiles.

---

dlls/advpack/advpack.c |   25 +++++++++++++++++++++++--
 1 files changed, 23 insertions(+), 2 deletions(-)

diff --git a/dlls/advpack/advpack.c b/dlls/advpack/advpack.c
index 31fa51c..9e09a9b 100644
--- a/dlls/advpack/advpack.c
+++ b/dlls/advpack/advpack.c
@@ -578,10 +578,31 @@ HRESULT WINAPI ExecuteCab( HWND hwnd, PC
 /***********************************************************************
  *             ExtractFiles    (ADVPACK.@)
  *
+ * Extracts the specified files from a cab archive into
+ * a destination directory.
+ *
+ * PARAMS
+ *   CabName   [I] Filename of the cab archive.
+ *   ExpandDir [I] Destination directory for the extracted files.
+ *   Flags     [I] Reserved.
+ *   FileList  [I] Optional list of files to extract.  See NOTES.
+ *   LReserved [I] Reserved.  Must be NULL.
+ *   Reserved  [I] Reserved.  Must be 0.
+ *
+ * RETURNS
+ *   Success: S_OK.
+ *   Failure: E_FAIL.
+ *
+ * NOTES
+ *   FileList is a colon-separated list of filenames.  If FileList is
+ *   non-NULL, only the files in the list will be extracted from the
+ *   cab file, otherwise all files will be extracted.  Any number of
+ *   spaces, tabs, or colons can be before or after the list, but
+ *   the list itself must only be separated by colons.
+ *
  * BUGS
- *   Unimplemented
+ *   Unimplemented.
  */
-
 HRESULT WINAPI ExtractFiles ( LPCSTR CabName, LPCSTR ExpandDir, DWORD Flags,
                               LPCSTR FileList, LPVOID LReserved, DWORD Reserved)
 {