CStringT::AllocSysString
Выбирает строку Автоматизация- совместимого типа, BSTR и копирует в него содержимое объекта CStringT, включая конечный нуль-символ.
BSTR AllocSysString() const;
Возвращаемое значение
Вновь выбранная строка.
Заметки
В программах MFC, Класс CMemoryException создается, если существует недостаток памяти. В программах, CAtlException библиотеки ATL. Эта функция обычно используется для возврата строки для автоматизации.
Как правило, если эта строка передается функции модели COM как [in] Параметр, то это требует, чтобы вызывающий освобождает строку. Это делается с помощью SysFreeString, как описано в Windows SDK. Дополнительные сведения см. в разделе Allocating and Releasing Memory for a 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