Used to convert among virtual, local, and UNC paths (Windows only)


File: dtsfc.h
Namespace: dtSearch


|
Name |
Description |
---|---|---|
![]() |
Result of the conversion | |
![]() |
Input path for conversion | |
![]() |
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. |




|
Name |
Description |
---|---|---|
![]() |
Result of the conversion | |
![]() |
Input path for conversion | |
![]() |
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. |
|
Name |
Description |
---|---|---|
![]() |
Convert virtual folder name Path to a local path, which will be returned in ConvertedPath | |
![]() |
Convert Path to a UNC path, which will be returned in ConvertedPath | |
![]() |
Convert local folder name Path to a virtual path, which will be returned in ConvertedPath | |
![]() |
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. |


|
Name |
Description |
---|---|---|
![]() |
Convert virtual folder name Path to a local path, which will be returned in ConvertedPath | |
![]() |
Convert Path to a UNC path, which will be returned in ConvertedPath | |
![]() |
Convert local folder name Path to a virtual path, which will be returned in ConvertedPath | |
![]() |
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. |


![]() |
Data Member |
![]() |
Method |
![]() |
protected |


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.


