Environment Manager Engineering Setting - CreateSpecialPaths

Version 1

    Verified Product Versions

    AppSense Environment Manager 8.6AppSense Environment Manager 8.5AppSense Environment Manager 8.4AppSense Environment Manager 8.2AppSense Environment Manager 8.1AppSense Environment Manager 8.3AppSense Environment Manager 8.0

    Introduction

    Logon delays when redirecting folders to a CIFS share.

    Null entries in the "Shell Folders" registry key (HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders)

    Detail

    The Microsoft API, SHGetFolderPath, attempts to verify that a special folder exists if the "CSIDL_FLAG_DONT_VERIFY" flag is not passed when returning the path for a folder.

    If a special folder has been redirected to the network, this call can timeout and fail due to network and/or authentication issues as the initial call is made using the machine account. For customers experiencing this issue with folder redirection enabled to a CIFS sharem, adding an SPN for CIFS may also resolve the issue.

    These timeouts can cause significant delays during log-on as there could be a 5 second delay for each CSIDL path being enumerated.

    Additionally, in certain circumstances, calling SHGetFolderPath for a special folder that is for some reason unavailable can result in the "HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" key (as opposed to the 'User Shell Folders' key) being NULLed. The "Shell Folders" key is a legacy key and should not be used, however, some applications, such as Lotus notes, still use it and encounter issues due to the null values within.

    The CreateSpecialPaths engineering setting was added to Environment Manager 8.2.125.0 and above to control the "CSIDL_FLAG_DONT_VERIFY" flag when calling SHGetFolderPath.
    Additionally, the default value for CreateSpecialPaths was changed from 1 (create/verify) to 0 (Do not create/verify) from Environment Manager 8.3.192.0 onwards.

     

    AppSense Product:        Environment Manager

     

    Engineering Settings:   

     

    Introduced (Agent):      Environment Manager 8.2.125.0

     

    Deprecated (Agent):      N/A

     

    Introduced (Console):    Environment Manager 8.3.157.0

     

    Deprecated (Console):    N/A

    Note - Certain common engineering settings have been made configurable via the "Custom Settings" option within the Environment Manager Console (only applicable to 8.3.157.0 and later)

    Valid Registry Hives (* = highest priority, where applicable):

     

    HKEY_CURRENT_USER        No

     

    HKEY_LOCAL_MACHINE       Yes

     

    8.0.x.x Registry Key:    N/A

     

    8.1.x.x + Registry Key:  \Software\AppSense\Environment Manager

     

    Registry Value Name:     CreateSpecialPaths

     

    Registry Value Type:     REG_DWORD

     

    Registry Value Data:     0 or 1

    Prior to 8.3.192.0:

     

    Default (if not set):    1 (Paths are verified / created, "CSIDL_FLAG_DONT_VERIFY" flag is not set)

    Post 8.3.192.0:

     

    Default (if not set):    0 (Paths are not verified / created, "CSIDL_FLAG_DONT_VERIFY" flag is set)

    Limitations: N/A

    See Also:

    • TN-150617 - Slow logon experienced when using folder redirection with a NetApp filer