CStringT::AllocSysString
Aloca uma seqüência de caracteres compatível com a automação do tipo BSTR e copia o Sumário das CStringT objeto, incluindo o caractere nulo de terminação.
BSTR AllocSysString() const;
Valor de retorno
A seqüência de caracteres recém-alocada.
Comentários
A Classe CMemoryException é lançada se existe memória suficiente. Esta função normalmente é usada para retornar seqüências de caracteres para automação.
Normalmente, se essa seqüência é passada para uma função COM sistema autônomo um parâmetro [in], isso requer o chamador liberar a cadeia de caracteres.Isso pode ser concluído usando SysFreeString, conforme descrito no Windows SDK. Para obter mais informações, consulte Alocando e liberando memória para um BSTR.
Para obter mais informações sobre as funções de alocação de OLE no Windows, consulte SysAllocString in the Windows SDK.
Exemplo
O exemplo a seguir demonstra o uso de 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.
Requisitos
Cabeçalho: cstringt.h