From: Gé van Geldorp <ge@gse.nl>
Date: Sun, 20 Nov 2005 14:54:49 +0000 (+0000)
Subject: Sync to Wine-0_9_1:
X-Git-Tag: backups/ros-branch-0_2_9@19949~552
X-Git-Url: https://git.reactos.org/?p=reactos.git;a=commitdiff_plain;h=c96938839662f3290c2ce8da59bcad1ac6ccd847

Sync to Wine-0_9_1:
Markus Amsler <markus.amsler@oribi.org>
Improve c2man Documented-Total count. Changes:
- add missing returns section

svn path=/trunk/; revision=19368
---

diff --git a/reactos/lib/uxtheme/system.c b/reactos/lib/uxtheme/system.c
index 974d85ec0ea..79151acfdb9 100644
--- a/reactos/lib/uxtheme/system.c
+++ b/reactos/lib/uxtheme/system.c
@@ -600,7 +600,13 @@ HTHEME WINAPI OpenThemeData(HWND hwnd, LPCWSTR pszClassList)
 /***********************************************************************
  *      GetWindowTheme                                      (UXTHEME.@)
  *
- * Retrieve the last theme opened for a window
+ * Retrieve the last theme opened for a window.
+ *
+ * PARAMS
+ *  hwnd  [I] window to retrieve the theme for
+ *
+ * RETURNS
+ *  The most recent theme.
  */
 HTHEME WINAPI GetWindowTheme(HWND hwnd)
 {
@@ -788,6 +794,10 @@ DWORD WINAPI QueryThemeServices()
  *     pszColorName        Color defined in the theme, eg. NormalColor
  *     pszSizeName         Size defined in the theme, eg. NormalSize
  *     hThemeFile          Handle to theme file
+ *
+ * RETURNS
+ *     Success: S_OK
+ *     Failure: HRESULT error-code
  */
 HRESULT WINAPI OpenThemeFile(LPCWSTR pszThemeFileName, LPCWSTR pszColorName,
                              LPCWSTR pszSizeName, HTHEMEFILE *hThemeFile,
@@ -806,6 +816,10 @@ HRESULT WINAPI OpenThemeFile(LPCWSTR pszThemeFileName, LPCWSTR pszColorName,
  *
  * PARAMS
  *     hThemeFile           Handle to theme file
+ *
+ * RETURNS
+ *     Success: S_OK
+ *     Failure: HRESULT error-code
  */
 HRESULT WINAPI CloseThemeFile(HTHEMEFILE hThemeFile)
 {
@@ -824,6 +838,10 @@ HRESULT WINAPI CloseThemeFile(HTHEMEFILE hThemeFile)
  *     unknown              See notes
  *     hWnd                 Window requesting the theme change
  *
+ * RETURNS
+ *     Success: S_OK
+ *     Failure: HRESULT error-code
+ *
  * NOTES
  * I'm not sure what the second parameter is (the datatype is likely wrong), other then this:
  * Under XP if I pass
@@ -854,6 +872,10 @@ HRESULT WINAPI ApplyTheme(HTHEMEFILE hThemeFile, char *unknown, HWND hWnd)
  *     dwColorNameLen      Length, in characters, of color name buffer
  *     pszSizeName         Buffer to receive the default size name
  *     dwSizeNameLen       Length, in characters, of size name buffer
+ *
+ * RETURNS
+ *     Success: S_OK
+ *     Failure: HRESULT error-code
  */
 HRESULT WINAPI GetThemeDefaults(LPCWSTR pszThemeFileName, LPWSTR pszColorName,
                                 DWORD dwColorNameLen, LPWSTR pszSizeName,
@@ -885,6 +907,10 @@ HRESULT WINAPI GetThemeDefaults(LPCWSTR pszThemeFileName, LPWSTR pszColorName,
  *     pszThemePath        Path containing themes
  *     callback            Called for each theme found in path
  *     lpData              Passed through to callback
+ *
+ * RETURNS
+ *     Success: S_OK
+ *     Failure: HRESULT error-code
  */
 HRESULT WINAPI EnumThemes(LPCWSTR pszThemePath, EnumThemeProc callback,
                           LPVOID lpData)
@@ -1097,6 +1123,10 @@ HRESULT WINAPI ParseThemeIniFile(LPCWSTR pszIniFileName, LPWSTR pszUnknown,
  *
  * PARAMS
  *     pszIniFileName      Path to a theme file
+ *
+ * RETURNS
+ *     Success: S_OK
+ *     Failure: HRESULT error-code
  */
 HRESULT WINAPI CheckThemeSignature(LPCWSTR pszThemeFileName)
 {