CStringT::SetSysString
Realoca o BSTR apontada por pbstr e copia o Sumário das CStringT objeto, incluindo o NULL caractere.
BSTR SetSysString(
BSTR* pbstr
) const;
Parâmetros
- pbstr
Um ponteiro para uma seqüência de caractere.
Valor de retorno
A nova seqüência.
Comentários
Dependendo do Sumário do CStringT objeto, o valor das BSTR referenciado por pbstr pode alterar. A função lança um CMemoryException Se houver memória suficiente.
Esta função é normalmente usada para alterar o valor de seqüências de caracteres passada por referência para automação.
Para obter mais informações sobre as funções de realocação de OLE no Windows, consulte SysReAllocStringLen e SysFreeString.
Exemplo
BSTR bstr = ::SysAllocString(L"Golf is fun!");
// create a CAtlString and change the OLE
// string to the contents of the BSTR
// typedef CStringT<TCHAR, StrTraitATL<TCHAR, ChTraitsCRT<TCHAR>>> CAtlString;
CAtlString str(_T("Soccer is best!"));
BSTR bstr2 = str.SetSysString(&bstr);
// Now, both bstr and bstr2 reference a single instance of
// the "Soccer" string. The "Golf" string has been freed.
ASSERT(bstr2 == bstr);
Requisitos
Cabeçalho: cstringt.h