IGpibIntfcMessage::ReadString

Description

Synchronously transfers data from a device. The data that is read is returned in the BSTR pBuffer. This function returns only when the transfer terminates. Only one synchronous read function can occur at any one time.

A read can terminate successfully due to receiving the requested number of bytes, receiving the read termination character (if enabled), or receiving the END signal.

VB Prototype

value As String = ReadString(
  count As Long
)

C++ Prototype

HRESULT ReadString(
  long count,
  BSTR* pBuffer
);

Parameters

count

The number of bytes to read.

pBuffer

The read I/O data in a string.

Return Value

Refer to the table of return codes.

See Also

ComponentVersion, SpecVersion, HardwareInterfaceName, HardwareInterfaceNumber, HardwareInterfaceType, LockState, OptionString, ProgID, ResourceName, SessionType, SoftwareManufacturerID, SoftwareManufacturerName, Timeout, LastStatus, SendEndEnabled, TerminationCharacter, TerminationCharacterEnabled, GetAttribute, SetAttribute, LockRsrc, UnlockRsrc, Init, Close, AssertTrigger, Read, ReadString, Write, WriteString, IGpibIntfcMessage Overview