Registry key where virtual-to-local tables are kept. Unless your application sets up these tables in an alternative location, leave blank to use the default location.
Registry key where virtual-to-local tables are kept. Unless your application sets up these tables in an alternative location, leave blank to use the default location.
Read virtual-to-local mappings from the Metabase and store them in the registry. This call will often fail if made from within an IIS process, due to lack of sufficient rights.
Read virtual-to-local mappings from the Metabase and store them in the registry. This call will often fail if made from within an IIS process, due to lack of sufficient rights.
Execute the conversion, producing output in ConvertedPath.
Remarks
Internet Information Server stores its mapping between virtual and local paths in the Metabase. Reading this information from the Metabase is time-consuming and requires access rights that may not be available to a process running in the
web server context. Therefore, the dtSearch Engine caches this information in the registry, under the key HKEY_LOCAL_MACHINE\Software\dtSearch Corp.\dtSearch\Virtual Roots. By default, the conversion will use the cached table values. Call ConvertPath with the dtsCpRefreshMappings + dtsCpStoreInRegistry flags to update the cached information. (Running dtWebSetup.exe, the dtSearch Web Setup program, will also update this information.)
If path conversion returns a blank string, it means that either (1) the folder passed in does not have a virtual directory associated with it, or (2) the registry tables have not been refreshed since the virtual directory was created.