ReadString

Reads string data from a device.

virtual HRESULT ReadString(CString& pResult, long lTimeout = CUR_TIMEOUT) override;

virtual HRESULT ReadString(BSTR* pResult, long lTimeout = CUR_TIMEOUT) override;

Parameters

pResult: [out] String data read from the device.
lTimeout: [in] I/O timeout value in milliseconds.

Return Value

Returns S_OK if successful, otherwise a failure HRESULT.

Remarks

The ReadString function reads from the formatted I/O read buffer until an END condition or termination character is encountered.

Example

The following example demonstrates use of the ReadString function.

C++

Copy

// CoAcme4321.cpp
STDMETHODIMP Acme4321::IAcme4321_QueryData(BSTR* pbstrData)
{
  HRESULT hr = S_OK;

  // Read until END or termchar encountered
  hr = io.ReadString(pbstrData);

  return hr;
}

Other Resources