Edit

SysReAllocStringLen function (oleauto.h)

  • Article

Creates a new BSTR containing a specified number of characters from an old BSTR, and frees the old BSTR.

Syntax

INT SysReAllocStringLen(
  [in, out]      BSTR          *pbstr,
  [in, optional] const OLECHAR *psz,
  [in]           unsigned int  len
);

Parameters

[in, out] pbstr

The previously allocated string.

[in, optional] psz

The string from which to copy len characters, or NULL to keep the string uninitialized.

[in] len

The number of characters to copy. A null character is placed afterward, allocating a total of len plus one characters.

Return value

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

Remarks

Allocates a new string, copies len characters from the passed string into it, and then appends a null character. Frees the BSTR referenced currently by pbstr, and resets pbstr to point to the new BSTR. If psz is null, a string of length len is allocated but not initialized.

The psz string can contain embedded null characters and does not need to end with a null.

If this function is passed a NULL pointer, 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