Выделяет новую строку и копирует в нее заданную строку. Возвращает NULL, если не хватает памяти или если параметр имеет значение NULL.
BSTR SysAllocString
(
OLECHAR FAR* sz
);
Параметр:
- sz - Завершающаяся нулевым символом строка, которая копируется в новую BSTR. Параметр sz должен быть строкой Unicode в 32-разрядных приложениях и строкой ANSI — в 16-разрядных.
Возвращаемое значение:
В случае успеха указывает на BSTR, содержащую заданную строку. При недостатке памяти или если sz равно NULL, возвращается NULL.
Комментарии:
Строки, выделенные SysAllocString, освобождаются с помощью SysFreeString.
Пример:
inline void CStatBar::SetText(OLECHAR FAR* sz)
{
SysFreeString(m_bstrMsg);
m_bstrMsg = SysAllocString(sz);
}