dtsConvertPathRequest Structure

Used by dtssConvertPath2 to convert among virtual, local, and UNC paths

struct dtsConvertPathRequest {
  dtsErrorInfo * errorHandler;
  long flags;
  char * dest;
  long maxLen;
  const char * path;
  long siteId;
  const char * registryKey;
};

File

dtsearch.h

Members

Members	Description
dtsErrorInfo * errorHandler;	Pointer to a dtsErrorInfo to store any error messages generated during the job
long flags;	ConvertPathFlags indicating the type of conversion to perform
char * dest;	Output buffer for the conversion
long maxLen;	Size of the output buffer for the conversiondtsLi
const char * path;	Input path to convert
long siteId;	ID of the web site on a web server.
const char * registryKey;	Registry key where virtual-to-local path mappings are stored.

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_MACHINESoftwaredtSearch Corp.dtSearchVirtual 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.

Group

Structs, Records, Enums

Links

Structs, Records, Enums