CStringT::AllocSysString

자동화 호환 문자열 형식의 할당 BSTR 의 내용을 복사 하 고는 CStringT null 종결 문자를 포함 하 여 개체에 해당 합니다.

BSTR AllocSysString() const;

반환 값

새로 할당 된 문자열입니다.

설명

MFC 프로그램에는 CMemoryException 클래스 메모리가 부족 하 여 존재 하는 경우에 throw 됩니다.ATL 프로그램에는 CAtlException throw 됩니다.이 함수는 자동화에 대 한 문자열을 반환 합니다. 일반적으로 사용 됩니다.

이 문자열 COM 함수는 [in] 매개 변수로 전달 되는 경우 일반적으로 다음이 문자열을 해제 하려면 호출자가 필요 합니다.이 사용 하 여 수행할 수 있습니다 SysFreeString에 설명 된 대로, 여 Windows SDK.자세한 내용은 할당 하 고 메모리를 BSTR 해제를 참조하십시오.

Windows에서 OLE 할당 함수에 대 한 자세한 내용은 SysAllocString 에 있는 Windows SDK.

예제

다음 예제는 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.   

요구 사항

헤더: cstringt.h

참고 항목

참조

CStringT 클래스