Used to convert among virtual, local, and UNC paths (Windows only)
File: dtsfc.h
Namespace: dtSearch
|
Data Member |
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. |
|
Data Member |
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. |
|
Method |
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. |
|
Method |
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. |
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.