DConvertPathRequest Class

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

File

File: dtsfc.h

Namespace: dtSearch

Syntax

C++

class DConvertPathRequest;

Data Members

	Name	Description
	ConvertedPath	Result of the conversion
	Path	Input path for conversion
	TableRegistryKey	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.

Group

Classes

Members

Data Members

	Name	Description
	ConvertedPath	Result of the conversion
	Path	Input path for conversion
	TableRegistryKey	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.

Methods

Show:Protected

No members matching the current filter

	Name	Description
	MakeLocal	Convert virtual folder name Path to a local path, which will be returned in ConvertedPath
	MakeUNC	Convert Path to a UNC path, which will be returned in ConvertedPath
	MakeVirtual	Convert local folder name Path to a virtual path, which will be returned in ConvertedPath
	RefreshMappings	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.
	executeRequest	Execute the conversion, producing output in ConvertedPath.

Methods

Show:Protected

No members matching the current filter

	Name	Description
	MakeLocal	Convert virtual folder name Path to a local path, which will be returned in ConvertedPath
	MakeUNC	Convert Path to a UNC path, which will be returned in ConvertedPath
	MakeVirtual	Convert local folder name Path to a virtual path, which will be returned in ConvertedPath
	RefreshMappings	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.
	executeRequest	Execute the conversion, producing output in ConvertedPath.

Legend

Data Member

Method

protected

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.

Class Hierarchy