GetImplementationObject

Returns a data structure for an implementation object, such as might be part of a communications driver implementation. This function might be useful for extending the functionality of an existing driver.

If your communications driver implementation aggregates another communications driver, such that you have an additional object that mediates communication with the driver handle and service handle, then this method can return implementation objects such as the driver handle, service handle, or some other structure.

An aggregate communications driver implementation typically includes a Siebel driver and a separate driver called the aggregate communications driver that extends the main driver’s functionality or replaces part of its functionality.

If you write an aggregate communications driver, then it might be useful to invoke the aggregate driver for certain functions. The aggregate communications driver intercepts certain commands for its special operation and passes other commands on to the existing communications driver.

The aggregate driver must be added to the Communications Drivers and Profiles view, so that the driver can be properly initialized and used.

Writing an aggregate communications driver to work with an existing communications driver can save much time compared with writing a driver from scratch.

ISCAPI ISC_RESULT   	GetImplementationObject
   /* in  */(ISC_HANDLE     key, 
   /* out */ ISC_HANDLE*    impObj);