CStringT::AllocSysString
Alloue une chaîne automation compatible du type BSTR et copie le contenu de l'objet d' CStringT dans ce fichier, y compris le caractère NULL de fin.
BSTR AllocSysString() const;
Valeur de retour
La chaîne nouvellement alloué.
Notes
Dans les programmes MFC, Classe de CMemoryException est levée si la mémoire insuffisante existe.Dans les programmes ATL, CAtlException est levée.Cette fonction est généralement utilisée pour retourner des chaînes pour l'automation.
En général, si cette chaîne est passée à une fonction COM comme [in] paramètre, puis cela requiert que l'appelant de libérer la chaîne.Cette opération peut être effectuée à l'aide de SysFreeString, comme décrit dans Kit de développement logiciel Windows.Pour plus d'informations, consultez Allouant et libère la mémoire pour un BSTR.
Pour plus d'informations sur OLE de fonctions d'allocation dans windows, consultez SysAllocString dans Kit de développement logiciel Windows.
Exemple
L'exemple suivant illustre l'utilisation du mot clé 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.
Configuration requise
Header: cstringt.h