SysReAllocStringLen

This function creates a new BSTR that contains a specified number of characters from an old BSTR, and frees the old BSTR.

At a Glance

Syntax

HRESULT SysReAllocStringLen(BSTR FAR* pbstr, OLECHAR FAR* pch, unsigned int cch);

Parameters

pbstr

Pointer to a variable that contains a BSTR.

pch

Pointer to cch characters to copy, or NULL to keep the string uninitialized.

cch

Number of characters to copy from pch. A null character is placed afterward, allocating a total of cch+1 characters.

Return Values

TRUE indicates that the string is reallocated successfully. FALSE indicates that insufficient memory exists.

Remarks

The SysReAllocStringLen function allocates a new string, copies cch 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 pch is NULL, a string of length cch is allocated but not initialized.

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

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.