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 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 Allocating and Releasing Memory for a 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