7. Configuration Functions

See Section 3.7 for the overall discussion of configuration information. The configuration functions are used by service providers and applications to write and retrieve the configuration information for a WOSA/XFS subsystem, which is stored in a hierarchical structure called the XFS configuration registry. The structure and the functions are based on the Win32 Registry architecture and API functions, and are implemented in Windows NT and future versions of Windows using the Registry and the associated functions. For Win32s-based implementations on Windows 3.1 and Windows for Workgroups, a subset of the functionality described here will be available; see the SDK for the definition of this subset.

The logical structure of the configuration information is shown below.

The XFS Manager key has the following optional values:

• TraceFile the name of the file containing trace data. If this value is not set in the configuration, trace data is written to the default file path\name C:\XFSTRACE.LOG.

• ShareFilename the name of the memory mapped file used by the memory management functions of the XFS Manager.

• ShareFilesize the size of the memory mapped file used by the memory management functions of the XFS Manager.

Some additional values could be also defined in the WOSA/XFS SDK release notes. Please refer to the related document for more information.

A logical service key has three mandatory values:

• class the service class of the logical service. The standard values are described in the Service Class Definition Document and in the service class include files.

• type the service type of the logical service; the standard values are in the SDK

• provider the name of the service provider that provides the logical service
  (the key name of the corresponding service provider key)

A service provider key also has three mandatory values:

• dllname the name of the file containing the service provider DLL

• vendor_name the name of the supplier of this service provider

• version the version number of this service provider

WOSA/XFS_ROOT

XFS_MANAGER

TraceFile=<path-name>\<trace-file- name>

ShareFilename=<path-name>\ <share-file-name>

ShareFilesize=<file size in bytes>

LOGICAL_SERVICES

<Logical Service Name>

class=<service class>

type=<service type>

provider=<provider name>

< optional values >

SERVICE_PROVIDERS

<Provider Name>

dllname=< DLL name>

vendor_name=<vendor name>

version=<version>

< optional values >

< other keys >