SysReAllocString function (oleauto.h)

Reallocates a previously allocated string to be the size of a second string and copies the second string into the reallocated memory.

Syntax

INT SysReAllocString(
  [in, out]      BSTR          *pbstr,
  [in, optional] const OLECHAR *psz
);

Parameters

[in, out] pbstr

The previously allocated string.

[in, optional] psz

The string to copy.

Return value

Return code Description
TRUE
The string is reallocated successfully.
FALSE
Insufficient memory exists.

Remarks

The address passed in psz cannot be part of the string passed in pbstr, or unexpected results may occur.

If pbstr is NULL, there will be an access violation and the program will crash. It is your responsibility to protect this function against NULL pointers.

Requirements

Requirement Value
Target Platform Windows
Header oleauto.h
Library OleAut32.lib
DLL OleAut32.dll

See also

String Manipulation Functions