Click or drag to resize

SetAttribute

Sets an attribute on the VISA I/O session.

virtual HRESULT SetAttribute(long lAttribute, UINT32 value) abstract;

virtual HRESULT SetAttribute(long lAttribute, UINT64 value) abstract;

virtual HRESULT SetAttribute(long lAttribute, bool value) abstract;

virtual HRESULT SetAttribute(long lAttribute, const CString& value) abstract;
Parameters
lAttribute

[in] Attribute ID of the session attribute to set.

value

[in] Value to which the attribute will be set.

Return Value

Returns S_OK if successful, otherwise a failure HRESULT.

Remarks

The SetAttribute function can be used to exercise very low-level control over the VISA I/O session. The allowed values for the lAttribute correspond to the VISA attribute ID values available in the VISA specification. These values may also be found in the visa.h header file. See the VISA specification for details.

Example

The following example demonstrates use of the SetAttribute function.

C++
// CoAcme4321.cpp
STDMETHODIMP Acme4321::IAcme4321_OnFinalInitialize()
{
  HRESULT hr = S_OK;

  hr = io.SetAttribute(VI_ATTR_SEND_END_EN, true);

  return hr;
}
See Also

Other Resources

Download a complete CHM version of this documentation here.