Справочник по технологии COM
Страница 12. SysAllocString


 

SysAllocString

Выделяет новую строку и копирует в нее заданную строку. Возвращает 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);
}

 
Следующая статья »