CStringT::AllocSysString
Alloca una serie dell'automazione compatibile del tipo BSTR e copia il contenuto dell'oggetto CStringT in, incluso il carattere di terminazione null.
BSTR AllocSysString() const;
Valore restituito
La stringa appena allocati.
Note
Nei programmi MFC, Classe di CMemoryException viene generato se la memoria insufficiente esiste.Nei programmi ATL, CAtlException viene generato.Questa funzione è generalmente utilizzata per restituire le stringhe di automazione.
Generalmente, se questa stringa viene passata una funzione COM come [in] parametro, questo richiede al chiamante liberare la stringa.Questa operazione può essere eseguita utilizzando SysFreeString, come descritto in Windows SDK.Per ulteriori informazioni, vedere Mediante l'allocazione e il rilascio di memoria per un BSTR.
Per ulteriori informazioni sulle funzioni di allocazione OLE in Windows, vedere SysAllocString in Windows SDK.
Esempio
Nell'esempio seguente viene illustrato l'utilizzo di 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.
Requisiti
Header: cstringt.h