RDS 2.5 API Reference

Handler Property (RDS)

Indicates the name of a server-side customization program (handler) that extends the functionality of the RDSServer.DataFactory, and any parameters used by the handler.

Syntax

DataControl.Handler = String

Parameters

DataControl
An object variable that represents an RDS.DataControl object.
String
A String value that contains the name of the handler and any parameters, all separated by commas (for example, "handlerName,parm1,parm2,...,parmN").

Remarks

This property supports customization, a functionality that requires setting the CursorLocation property to adUseClient.

The name of the handler and its parameters, if any, are separated by commas (","). Unpredictable behavior will result if a semicolon (";") appears anywhere within String. You can write your own handler, provided it supports the IDataFactoryHandler interface.

The name of the default handler is MSDFMAP.Handler, and its default parameter is a customization file named MSDFMAP.INI. Use this property to invoke alternate customization files created by your server administrator.

The alternative to setting the Handler property is to specify a handler and parameters in the ConnectionString property; that is, "Handler=handlerName,parm1,parm2,...;".

See Also

Visual Basic Example

DataFactory Customization | DataFactory Object (RDSServer)

Applies To: DataControl Object (RDS)

© 1998-2003 Microsoft Corporation. All rights reserved.