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

Consulte também

Referência

Classe CStringT

Outros recursos

CStringT membros