VBA/VB6 - My Documents + Environment Variables

The "My Documents" folder path contains a variable username component and changes from one user to another. It is possible to write a code in VBA or VB6 to access the "My Documents" folder regardless of the username, with the help of functions that can read environment variables in VB6. As with every programming language,writing code in VB6 or VBA requires knowledge of basic programming concepts including subroutines, loops, and specific VB6 functions.Environment functions such as Environ$ which receives the value of an environment variable, can be used to write a code to read environment variables in VB6.

As displayed in Windows Explorer, the My Documents folder appears to be in the root, but this is not the case. It is located in a subdirectory of C:\Documents and Settings. The problem is that this subdirectory takes the user's name and is changed not only from one PC to another, but also on PCs supporting multiple users.The following codes allow you to access the My Documents folder by default regardless of the user logged on.

With VBA

Just paste the following code in a general module:

Option Explicit
Private Type SHITEMID
cb As Long
abID As Byte
End Type
End Type
Private Const CSIDL_PERSONAL As Long = &H5
Private Declare Function SHGetSpecialFolderLocation Lib "shell32.dll" _
(ByVal hwndOwner As Long, ByVal nFolder As Long, _
pidl As ITEMIDLIST) As Long
Private Declare Function SHGetPathFromIDList Lib "shell32.dll" Alias "SHGetPathFromIDListA" _
ByVal pidl As Long, ByVal pszPath As String As Long
Public Function Rep_Documents() As String
Dim lRet As Long, IDL As ITEMIDLIST, sPath As String
lRet = SHGetSpecialFolderLocation(100&, CSIDL_PERSONAL, IDL)
If lRet = 0 Then
sPath = String$(512, Chr$(0))
lRet = SHGetPathFromIDList(ByVal IDL.mkid.cb, ByVal sPath)
Rep_Documents = Left$(sPath, InStr(sPath, Chr$(0)) - 1)
Rep_Documents = vbNullString
End If
End Function
To call the function, simply create a button and paste in the following code:
Private Sub CommandButton1_Click()
Cells(5, 2) = Rep_Documents()
End Sub

With VB6

Under VB6, use the environment variable UserProfile (this also works with VBA):

Dim sPathUser as String    
sPathUser = Environ$("USERPROFILE") & "\my documents\"
MsgBox sPathUser

Environment Functions

The Environ$ function is use to receive the value of an environment variable.
For example, when you used the WINDIR command (Windows), you would have obtained the folder where Windows is installed (C:\Windows\).
These variables can be used in batch files, through the Run utility and in a programming environment such as VB and VBA.

  • Typing % UserProfile% references the current user.
  • Typing % UserProfile%\My Documents" references the My Documents folder.
  • Typing %WinDir% gets the Windows folder.
  • Typing %tmp% gives you access to temporary files.

Windows Variables

  • Variables for the default user
    • TEMP temporary directory
    • TMP temporary directory
  • System variables
    • ComSpec variable path for the command prompt.
    • OS Returns OS in use.
    • Path?
    • PATHEXT?
    • PROCESSOR_ARCHITECTURE Returns the processor architecture (x86 etc ...)
    • PROCESSOR_IDENTIFIER Returns the processor ID.
    • PROCESSOR_REVISION Returns the number of processor revisions
    • TEMP temporary directory.
    • TMP temporary directory.
    • windir folder where Windows is installed.
    • SystemRoot folder where Windows is installed.

Note that:

If you are logged in as an administrator, the changes can be made through Control Panel/Advanced System/Environment Variables.
Photo: 123rf.com

Ask a question
CCM is a leading international tech website. Our content is written in collaboration with IT experts, under the direction of Jean-François Pillou, founder of CCM.net. CCM reaches more than 50 million unique visitors per month and is available in 11 languages.
This document, titled « VBA/VB6 - My Documents + Environment Variables », is available under the Creative Commons license. Any copy, reuse, or modification of the content should be sufficiently credited to CCM (ccm.net).