[QCKLNCH]

-Documented the required functions and modules.
-Minor cleanup.

svn path=/branches/GSoC_2017/shellext/; revision=75689

reactos/dll/shellext/qcklnch/CISFBand.cpp

@@ -15,7 +15,17 @@
 WINE_DEFAULT_DEBUG_CHANNEL(qcklnch);
 
 // ***Extras***
-
+/*++
+* @name _ILIsDesktop
+*
+* Checks whether the given PIDL is of Desktop folder or not.
+*
+* @param pidl
+*        PIDL to be checked.
+*
+* @return True if PIDL is of Desktop, otherwise false.
+*
+*--*/
 BOOL WINAPI _ILIsDesktop(LPCITEMIDLIST pidl)
 {
     return (pidl == NULL || pidl->mkid.cb == 0);
@@ -38,6 +48,17 @@ CISFBand::~CISFBand()
 }
 
 // Toolbar
+/*++
+* @name CreateSimpleToolbar
+*
+* Creates a toolbar and fills it up with buttons for enumerated objects.
+*
+* @param hWndParent
+*        Handle to the parent window, which receives the appropriate messages from child toolbar.
+*
+* @return The error code.
+*
+*--*/
 HRESULT CISFBand::CreateSimpleToolbar(HWND hWndParent)
 {
     // Declare and initialize local constants.     

reactos/dll/shellext/qcklnch/CISFBand.h

@@ -20,7 +20,7 @@ class CISFBand :
     public IShellFolderBand,
     public IContextMenu
 {
-    // band
+    // Band
     DWORD m_BandID;
     CComPtr<IUnknown> m_Site;
 

reactos/dll/shellext/qcklnch/CQuickLaunchBand.cpp

@@ -39,6 +39,20 @@ static const GUID CLSID_QuickLaunchBand = { 0x260cb95d, 0x4544, 0x44f6, { 0xa0,
     }
 
 // Pidl Browser
+/*++
+* @name PidlBrowse
+*
+* Opens a folder browser dialog,
+* allowing the user to select a folder for enumeration.
+*
+* @param hwnd
+*        A handle to browser dialog window.
+* @param nCSIDL
+*        A CSIDL representing the root from which the browse folder dialog shows the files and folders.
+*
+* @return The PIDL to selected folder.
+*
+*--*/
     LPITEMIDLIST PidlBrowse(HWND hwnd, int nCSIDL)
     {
         CComHeapPtr<ITEMIDLIST> pidlRoot;
@@ -65,7 +79,14 @@ static const GUID CLSID_QuickLaunchBand = { 0x260cb95d, 0x4544, 0x44f6, { 0xa0,
 
 /*****************************************************************************/
 // ATL Construct
-
+/*++
+* @name FinalConstruct
+*
+* Creates an instance of CISFBand, and initializes its Shell Folder Band for enumeration.
+*
+* @return The error code.
+*
+*--*/
     HRESULT CQuickLaunchBand::FinalConstruct()
     {
         HRESULT hr = CISFBand_CreateInstance(IID_PPV_ARG(IUnknown, &m_punkISFB));