SysReAllocString

This function allocates a new BSTR and copies the passed string into it, then frees the BSTR referenced by pbstr, and finally resets pbstr to point to the new BSTR.

At a Glance

Header file: Oleauto.h
Windows CE versions: 2.0 and later

Syntax

HRESULT SysReAllocString(BSTR FAR * pbstr, OLECHAR FAR * sz);

Parameters

pbstr

Pointer to a variable that contains a BSTR.

sz

Null-terminated string to copy.

Return Values

FALSE indicates that insufficient memory exists.

Remarks

Windows CE supports only Unicode strings.

Passing into this function any invalid and, under some circumstances, NULL pointers will result in unexpected termination of the application.