Tech Articles


Calling SHGetKnownFolderPath from PowerBuilder


Up through Windows XP, if you wanted to get the physical location of certain defined folders (e.g. the users Documents folder), you would use the SHGetFolderPath function in the Windows API.  Roland Smith has examples of using that on his Topwiz Software site.  That function continues to work in later versions of Windows, although it's basically a wrapper for the SHGetKnownFolderPath function.

SHGetFolderPath uses CSIDL values, whereas SHGetKnownFolderPath uses KnownFolderID GUIDs.  One difference is that there are a lot more KnownFolderIDs than there are CSIDLs.  That means some of the defined folder locations you may want to get the physical location for can't be accessed through the older SHGetFolderPath method.  And that's exactly the situation I ran into.


I needed to find the user's Downloads folder, and there isn't a CSIDL value for that.  So, I needed to see how to call the SHGetKnownFolderPath function from PowerBuilder.  As with many OLE and Windows API calls, it can save you a lot of time if you can find some Visual Basic code that does what you need to do, and you can convert the syntax.  And fortunately, I found some that did this.



So, with a little tweaking, I ended up with this:

//Local External Functions:

 Function Long CLSIDFromString (ref string lpszGuid, ref blob pGuid ) Library "ole32"   
 Function Long SHGetKnownFolderPath( ref blob nFolder,int dwFlags,uLong hToken , ref long pszPath) LIBRARY "Shell32.dll"   
 Subroutine CopyMemory ( ref String pDest, long pSrc, long ByteLen) Library "kernel32" Alias For "RtlMoveMemory"   
 Subroutine CoTaskMemFree ( long hMem) Library "ole32"   
 Function Long lstrlenW ( long ptr) Library "kernel32"   

//PowerScript

 blob     guid  
 long     ll_rc, ll_folderpointer, ll_folderlen  
 string ls_folder, ls_folder_id  
 ls_folder_id = '{374DE290-123F-4565-9164-39C4925E467B}'  
 IF CLSIDFromString (ls_folder_id, guid ) = 0 THEN  
      IF SHGetKnownFolderPath ( guid, 0, 0, ll_folderpointer ) = 0 THEN  
           IF ll_folderpointer <>0 THEN  
                ll_folderlen = lstrlenW ( ll_folderpointer )  
                If ll_folderlen <> 0 THEN  
                     ls_folder = Space ( ll_folderlen )                      
                     CopyMemory ( ls_folder, ll_folderpointer, ll_folderlen * 2 )  
                END IF  
           END IF  
           CoTaskMemFree ( ll_folderpointer )  
      END IF  
 END IF  
 MessageBox ( "Downloads Folder", ls_folder )  


Hope you find that useful as well.

 

 

 

 

 

 

Comments (1)
Tuesday, Sep 23 2025

I tried this with PB 2022 Build 1892 and it works the first time. The second call causes it to hang for a few seconds and then it aborts.

0

Find Articles by Tag

XML Source Control PDF PFC CoderObject WinAPI Installation PowerServer Mobile Transaction DataWindow Source Code DevOps Import DragDrop PowerServer Web TLS/SSL PBNI OLE SnapObjects Web Service Proxy OAuth Jenkins ActiveX 32-bit UI JSONParser PowerBuilder SVN RibbonBar Builder Filter Application Script Event Handling Branch & Merge Windows 10 Icons Syntax Trial Resize InfoMaker Database Table Data Database OAuth 2.0 Graph Database Connection Event WebBrowser Database Object Text Mobile Automated Testing File Deployment Azure 64-bit Linux OS SQL Server Expression Oracle CrypterObject BLOB Repository .NET DataStore Menu RichTextEdit Control Export Export JSON Design GhostScript DataType SqlExecutor Visual Studio Interface Import JSON Windows OS PBDOM JSONGenerator RibbonBar CI/CD Service Testing DataWindow JSON .NET Std Framework Array SQL Platform Database Profile JSON Validation iOS Stored Procedure TreeView License PostgreSQL ODBC driver HTTPClient API PostgreSQL TortoiseGit Migration TFS Elevate Conference Debug PowerBuilder Compiler UI Themes Debugging Excel Open Source Android External Functions IDE PBVM Model Database Table PowerBuilder (Appeon) Charts RESTClient SOAP PowerScript (PS) Event Handler Authorization SnapDevelop Messagging Configuration Variable COM Web API REST Error PDFlib Bug C# Icon Encoding SDK Outlook ODBC DLL OrcaScript SqlModelMapper Git Encryption Sort NativePDF MessageBox Window Performance UI Modernization Debugger Database Painter .NET Assembly Data Database Table Schema Class Authentication