DataBloc::WriteBSTR

The DataBloc::WriteBSTR function writes a BSTR string in the memory block.

Syntax

WriteBSTR(
    [number] Offset,
    [string] String,
);

Parameters

Offset

[number] Index in the memory block where the string will be written. It must be between 0 and Size - (String.length * 2) - 6.

String

[string] String to write in the memory block.

Return Value

There is no value returned by this function.

This function typically fails for the following reason:

• The Offset parameter is not in the range of possible valid values.

Remarks

The BSTR string is written like this: the first 4 bytes indicate the size of the string, in bytes. The following bytes constitute the string itself, in Unicode, ending with a null character. Thanks to that specific way of writing the string, null characters can be embedded in it.

Function Information

See Also

DataBloc Object, ReadBSTR.