Attributes for Status Simulation in IviFgen

When an IviFgen driver function is called, the driver queries whether NISFGEN_ATTR_SIMULATE_STATUS_CODE is enabled. If enabled, the driver gets the appropriate function's simulation status code. If the value of the simulation status code represents a warning (has a positive value), then it is returned as the function's return status only if no other error or warning occurred before the function ends. If the value of the simulation status code represents an error (has a negative value), then it is returned as the function's return status only if no other error occurred before the function ends.

The following IviFgen functions do not support status code simulation:

• IviFgen_GetError
• IviFgen_ClearError
• IviFgen_GetNextInterchangeWarning
• IviFgen_ResetNextInterchangeWarning
• IviFgen_ClearNextInterchangeWarning
• IviFgen_GetNextCoercionRecord
• IviFgen_LockSession
• IviFgen_UnlockSession
• IviFgen_CheckAttribute
• IviFgen_GetAttribute
• IviFgen_SetAttribute

Each function supported by the IviFgen class driver has a corresponding attribute that determines the status code to return when status code simulation is enabled. The following table lists the status code attributes and the function for which they return a value. These attributes are all of type ViInt32, non-readable, and non-channel based.

Note  In the following table, the literal string NISFGEN_ATTR_ precedes all attribute names.

IviFgen Attributes for Status Simulation