CStringT::AllocSysString
Выбирает строку Автоматизация- совместимого типа, BSTR и копирует в него содержимое объекта CStringT, включая конечный нуль-символ.
BSTR AllocSysString() const;
Возвращаемое значение
Вновь выбранная строка.
Заметки
В программах MFC, Класс CMemoryException создается, если существует недостаток памяти.В программах, CAtlException библиотеки ATL.Эта функция обычно используется для возврата строки для автоматизации.
Как правило, если эта строка передается функции модели COM как [in] Параметр, то это требует, чтобы вызывающий освобождает строку.Это делается с помощью SysFreeString, как описано в Windows SDK.Дополнительные сведения см. в разделе Выделение и освобождение памяти для BSTR.
Дополнительные сведения о функциях OLE распределения в Windows см. в разделе SysAllocString в Windows SDK.
Пример
Следующий пример демонстрирует использование CStringT::AllocSysString.
// typedef CStringT<TCHAR, StrTraitATL<TCHAR, ChTraitsCRT<TCHAR>>> CAtlString;
CAtlString str(_T("This is a test string!"));
BSTR bstr = str.AllocSysString();
// bstr now contains "This is a test string!", and can be
// passed to any OLE function requiring a BSTR.
// Normally, if you pass the BSTR, you will
// need to free the string after returning from the function call.
Требования
Header: cstringt.h