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).
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. |
Name | Description |
---|---|
Size | Size in bytes of the memory block attached to the object. |
DataPtr | Pointer to the actual data managed by this object. |