SysReAllocStringLen function (oleauto.h)
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 |
|---|---|
|
The string is reallocated successfully. |
|
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 |