Description The operation is used to retrieve the state of an attribute for the specified session, viGetAttribute() event, or find list. Related Items See viSetAttribute(). Implementation Requirements RULE 3.4.1 IF is a string attribute, THEN SHALL write no more than 256 characters attribute viGetAttribute into including the null character. attrState, OBSERVATION 3.4.1 RULE 3.4.1 states the maximum length of a VISA string attribute to be 255 characters. 3.4.1.2 viSetAttribute(vi, attribute, attrState) Purpose Set the state of an attribute. Parameters Name Direction Type Description vi IN ViSession Unique logical identifier to a session, event, ViEvent or find list. ViFindList attribute ViAttr IN Session, event, or find list attribute for which the state is modified. attrState ViAttrState IN The state of the attribute to be set for the specified resource. The interpretation of the individual attribute value is defined by the resource. Return Values This is the operational return status. It returns either a Type ViStatus completion code or an error code as follows. Completion Codes Description VI_SUCCESS Attribute value set successfully. VI_WARN_NSUP_ATTR_STATE Although the specified attribute state is valid, it is not supported by this implementation. Error Codes Description VI_ERROR_INV_SESSION The given session or object reference is invalid (both VI_ERROR_INV_OBJECT are the same value).
Description The viGetAttribute() operation is used to retrieve the state of an attribute for the specified session, event, or find list. Related Items See viSetAttribute(). Implementation Requirements RULE 3.4.1 IF attribute is a string attribute, THEN viGetAttribute SHALL write no more than 256 characters into attrState, including the null character. OBSERVATION 3.4.1 RULE 3.4.1 states the maximum length of a VISA string attribute to be 255 characters. 3.4.1.2 viSetAttribute(vi, attribute, attrState) Purpose Set the state of an attribute. Parameters Name Direction Type Description vi IN ViSession ViEvent ViFindList Unique logical identifier to a session, event, or find list. attribute IN ViAttr Session, event, or find list attribute for which the state is modified. attrState IN ViAttrState The state of the attribute to be set for the specified resource. The interpretation of the individual attribute value is defined by the resource. Return Values Type ViStatus This is the operational return status. It returns either a completion code or an error code as follows. Completion Codes Description VI_SUCCESS Attribute value set successfully. VI_WARN_NSUP_ATTR_STATE Although the specified attribute state is valid, it is not supported by this implementation. Error Codes Description VI_ERROR_INV_SESSION VI_ERROR_INV_OBJECT The given session or object reference is invalid (both are the same value).
vpp43_2018-10-19.docx