Internal object methods
For each ActiveX value object that you implement, a set of internal methods is created. Although these methods are not made available to the client application developer as ActiveX custom methods, you can use them when you add project-specific logic to your client and server projects.
These are the internal object methods, where Opaque is
the name of the opaque type that defines the current object.
| Method | Description |
|---|---|
| static OpaqueCommon * CreateNew() | Creates an instance of the current object. The object name is OpaqueServer if called by server code or OpaqueClient if called by client code. |
| void DkErrorRaise(MI_CONNECTION *conn, mi_integer msg_type, char *msg, ...) | Maps to mi_db_error_raise() on the server and raises an error on the client; for details, see the Informix® DataBlade® API Programmer's Guide. |
| OpaqueStruct * GetData() | Returns a pointer to the data structure representing the current object. |
| mi_boolean IsDirty() | Returns mi_true if the current object has been modified or mi_false if it has not. |
| OpaqueStruct * RawCopy() | Allocates a C data structure and fills it with a copy of the raw data of the current object. |
| void SetClean() | Flags the current object as having not been modified. |
| void SetData(const OpaqueStruct *value) | Fills the current object with the data supplied by the input data structure. |
| void SetDirty() | Flags the current object as having been modified. |
| void SetNotNull() | A protected method that sets the current object to not null. |