Attributes for Status Simulation in IviScope

When an IviScope driver function is called, the driver queries whether NISSCOPE_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 IviScope functions do not support status code simulation:

• IviScope_GetError
• IviScope_ClearError
• IviScope_GetNextInterchangeWarning
• IviScope_ResetNextInterchangeWarning
• IviScope_ClearNextInterchangeWarning
• IviScope_GetNextCoercionRecord
• IviScope_LockSession
• IviScope_UnlockSession
• IviScope_CheckAttribute
• IviScope_GetAttribute
• IviScope_SetAttribute

Each function supported by the IviScope class driver has a corresponding attribute that determines the status code to return when status code simulation is enabled. The following list indicates 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 NISSCOPE_ATTR_ precedes all attribute names.

IviScope Attributes for Status Simulation