Messenger Plus! Live - Scripting Documentation

The DataBloc object represents a memory block created by Interop.Allocate. It is used to create memory structure, convert data or send/receive parameters to/from external functions. It is to be used by advanced developers only. Every "read" function is paired with an equivalent "write". Every pair can be used in roundtrips, meaning that writing a value and reading it back always recreates the exact same original value.

When a DataBloc object is not used anymore, it is considered good practice to set its Size property to 0. This will free the memory allocated by the object immediately (to bypass the garbage collector of JScript that may take some time before deleting the actual object).

Functions:

Name Description
SetAt Writes a single byte in the memory block.
GetAt Reads a single byte from the memory block.
WriteString Writes a string  in the memory block.
WriteBSTR Writes a BSTR string in the memory block.
WriteWORD Writes a double-byte number in the memory block.
WriteDWORD Writes a 32bits integer in the memory block.
WriteInterfacePtr Writes an IDispatch pointer in the memory block.
ReadString Reads a string from the memory block.
ReadBSTR Reads a BSTR string from the memory block.
ReadWORD Reads a double-byte number from the memory block.
ReadDWORD Reads a 32 bits integer from the memory block.
ReadInterfacePtr Reads an IDispatch pointer from the memory block.

Properties:

Name Description
Size Size in bytes of the memory block attached to the object.
DataPtr Pointer to the actual data managed by this object.