Transformation Guide

Back Next

Working with Handles

Most functions are associated with a handle, such as INFA_CT_PARTITION_HANDLE. The first parameter for these functions is the handle the function affects. Custom transformation handles have a hierarchical relationship to each other. A parent handle has a 1:n
relationship to its child handle.

The following figure shows the Custom transformation handles:

The Custom transformation handles occur in the following parent-child hierarchy: INFA_CT_MODULE_HANDLE > INFA_CT_PROC_HANDLE > INFA_CT_TRANS_HANDLE > INFA_CT_PARTITION_HANDLE. INFA_CT_PARTITION_HANDLE is parent to INFA_CT_INPUTGROUP_HANDLE, which is parent to INFA_CT_INPUTPORT_HANDLE. INFA_CT_PARTITION_HANDLE is also parent to NFA_CT_OUTPUTGROUP_HANDLE, which is parent to INFA_CT_OUTPUTPORT_HANDLE.

The following table describes the Custom transformation handles:

Handle Name	Description
INFA_CT_MODULE_HANDLE	Represents the shared library or DLL. The external procedure can only access the module handle in its own shared library or DLL. It cannot access the module handle in any other shared library or DLL.
INFA_CT_PROC_HANDLE	Represents a specific procedure within the shared library or DLL. You might use this handle when you need to write a function to affect a procedure referenced by multiple Custom transformations.
INFA_CT_TRANS_HANDLE	Represents a specific Custom transformation instance in the session.
INFA_CT_PARTITION_HANDLE	Represents a specific partition in a specific Custom transformation instance.
INFA_CT_INPUTGROUP_HANDLE	Represents an input group in a partition.
INFA_CT_INPUTPORT_HANDLE	Represents an input port in an input group in a partition.
INFA_CT_OUTPUTGROUP_HANDLE	Represents an output group in a partition.
INFA_CT_OUTPUTPORT_HANDLE	Represents an output port in an output group in a partition.

Rename Saved Search

Table of Contents

Transformation Guide

Transformation Guide

Working with Handles

Working with Handles