Notification that an error condition has occurred during an operation invocation. Event Attributes Symbolic Name Access Privilege Data Type Range VI_ATTR_EVENT_TYPE ViEventType VI_EVENT_EXCEPTION RO VI_ATTR_STATUS RO ViStatus N/A VI_ATTR_OPER_NAME RO ViString N/A Event Attribute Descriptions Unique logical identifier of the event. VI_ATTR_EVENT_TYPE Status code returned by the operation generating the error. VI_ATTR_STATUS The name of the operation generating the event. VI_ATTR_OPER_NAME RULE 3.7.12 The name of the operation contained in SHALL be exactly as presented in this VI_ATTR_OPER_NAME specification, The VISA Library. OBSERVATION 3.7.7 For an exception generated from the operation, would contain the string viLock() VI_ATTR_OPER_NAME "viLock". OBSERVATION 3.7.8 The intent of providing is to be able to provide diagnostic information, such as VI_ATTR_OPER_NAME printing the name of the operation causing the event. Comparing the operation name in order to perform different actions, while valid, is not a recommended programming style. 3.7.3 Event Operations viEnableEvent(vi, eventType, mechanism, context) viDisableEvent(vi, eventType, mechanism) viDiscardEvents(vi, eventType, mechanism) viWaitOnEvent(vi, inEventType, timeout, outEventType, outContext) viInstallHandler(vi, eventType, handler, userHandle) viUninstallHandler(vi, eventType, handler, userHandle) Handler Prototype: viEventHandler(vi, eventType, context, userHandle) 3.7.3.1 viEnableEvent(vi, eventType, mechanism, context) Purpose Enable notification of a specified event. Parameters Name Direction Type Description vi IN ViSession Unique logical identifier to a session. eventType IN ViEventType Logical event identifier.
Notification that an error condition has occurred during an operation invocation. Event Attributes Symbolic Name Access Privilege Data Type Range VI_ATTR_EVENT_TYPE RO ViEventType VI_EVENT_EXCEPTION VI_ATTR_STATUS RO ViStatus N/A VI_ATTR_OPER_NAME RO ViString N/A Event Attribute Descriptions VI_ATTR_EVENT_TYPE Unique logical identifier of the event. VI_ATTR_STATUS Status code returned by the operation generating the error. VI_ATTR_OPER_NAME The name of the operation generating the event. RULE 3.7.12 The name of the operation contained in VI_ATTR_OPER_NAME SHALL be exactly as presented in this specification, The VISA Library. OBSERVATION 3.7.7 For an exception generated from the viLock() operation, VI_ATTR_OPER_NAME would contain the string "viLock". OBSERVATION 3.7.8 The intent of providing VI_ATTR_OPER_NAME is to be able to provide diagnostic information, such as printing the name of the operation causing the event. Comparing the operation name in order to perform different actions, while valid, is not a recommended programming style. 3.7.3 Event Operations viEnableEvent(vi, eventType, mechanism, context) viDisableEvent(vi, eventType, mechanism) viDiscardEvents(vi, eventType, mechanism) viWaitOnEvent(vi, inEventType, timeout, outEventType, outContext) viInstallHandler(vi, eventType, handler, userHandle) viUninstallHandler(vi, eventType, handler, userHandle) Handler Prototype: viEventHandler(vi, eventType, context, userHandle) 3.7.3.1 viEnableEvent(vi, eventType, mechanism, context) Purpose Enable notification of a specified event. Parameters Name Direction Type Description vi IN ViSession Unique logical identifier to a session. eventType IN ViEventType Logical event identifier.
vpp43_2015-06-19.docx