1 files changed, 15 insertions, 0 deletions

diff --git a/src/libs/dutil/WixToolset.DUtil/inc/shelutil.h b/src/libs/dutil/WixToolset.DUtil/inc/shelutil.h
index 0b9f539d..2ee7ce87 100644
--- a/src/libs/dutil/WixToolset.DUtil/inc/shelutil.h
+++ b/src/libs/dutil/WixToolset.DUtil/inc/shelutil.h
@@ -33,10 +33,25 @@ HRESULT DAPI ShelExecUnelevated(
     __in_z_opt LPCWSTR wzWorkingDirectory,
     __in int nShowCmd
     );
+
+/********************************************************************
+ ShelGetFolder() - translates the CSIDL into KNOWNFOLDERID and calls ShelGetKnownFolder.
+    If that returns E_NOTIMPL then falls back to ::SHGetFolderPathW.
+    The CSIDL_FLAG values are not supported, CSIDL_FLAG_CREATE is always used.
+    The path is backslash terminated.
+
+*******************************************************************/
 HRESULT DAPI ShelGetFolder(
     __out_z LPWSTR* psczFolderPath,
     __in int csidlFolder
     );
+
+/********************************************************************
+ ShelGetKnownFolder() - gets a folder by KNOWNFOLDERID with ::SHGetKnownFolderPath.
+    The path is backslash terminated.
+
+ Note: return E_NOTIMPL if called on pre-Vista operating systems.
+*******************************************************************/
 HRESULT DAPI ShelGetKnownFolder(
     __out_z LPWSTR* psczFolderPath,
     __in REFKNOWNFOLDERID rfidFolder