SetTrailingForWrites

str

[in] String which should be automatically appended to device command strings.

Many instruments require that command strings be terminated with a special character sequence. Rather than explicitly inserting these trailing characters into each command sent to the instrument, the SetTrailingForWrites function can be used to specify a set of characters that will automatically be appended to each command string sent to the device.

The default trailing string is the line feed character "\n".

The following example demonstrates use of the SetTrailingForWrites function.

// CoAcme4321.cpp
HRESULT Acme4321::OnFinalInitialize()
{
  HRESULT hr = S_OK;

  // Command strings will be automatically be appended with a CR/LF combination
  hr = io.SetTrailingForWrites(_T("\r\n"));

  return hr;
}

Other Resources