Microsoft MVP성태의 닷넷 이야기
VC++: 8. BSTR 메모리 할당 및 해제(MSDN Library 발췌) [링크 복사], [링크+제목 복사],
조회: 26337
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

Visual C++ 개념: 기능 추가  

BSTR의 메모리 할당 및 해제

BSTR을 만들고 COM 개체 간에 전달할 때는 BSTR에서 사용하는 메모리 처리에 주의하여 메모리 누수를 방지해야 합니다. BSTR이 인터페이스 내부에 있을 경우 사용한 메모리는 반드시 해제해야 합니다. 그러나 BSTR이 인터페이스 외부로 전달되는 경우에는 받는 개체에서 메모리를 관리합니다.

BSTR에 대해 메모리를 할당하고 할당된 메모리를 해제하는 일반적인 규칙은 다음과 같습니다.

  • BSTR 인수가 필요한 함수를 호출할 때는 호출하기 전에 BSTR에 대한 메모리를 할당한 후 나중에 해제합니다. 다음 코드에서는 이러한 예를 보여 줍니다.
    HRESULT IWebBrowser2::put_StatusText( BSTR bstr );
    
    // shows using the Win32 function 
    // to allocate memory for the string: 
    BSTR bstrStatus = ::SysAllocString( L"Some text" );
    if (bstrStatus == NULL)
       return E_OUTOFMEMORY;
    
    pBrowser->put_StatusText( bstrStatus );
    // Free the string:
    ::SysFreeString( bstrStatus );
    //...
  • BSTR을 반환하는 함수를 호출할 때는 문자열을 직접 해제해야 합니다. 다음 코드에서는 이러한 예를 보여 줍니다.
    HRESULT IWebBrowser2::get_StatusText( BSTR FAR* pbstr ); 
    //...
    BSTR bstrStatus;
    pBrowser->get_StatusText( &bstrStatus );
    
    // shows using the Win32 function 
    // to freee the memory for the string: 
    ::SysFreeString( bstrStatus );
  • BSTR을 반환하는 함수를 구현할 때는 문자열을 할당만 하고 해제하지는 않습니다. 해당 함수를 받는 개체에서 메모리를 해제합니다. 다음 코드에서는 이러한 예를 보여 줍니다.
    // Example shows using MFC's 
    // CString::AllocSysString
    
    //...
    HRESULT CMyClass::get_StatusText( BSTR * pbstr )
    {
    
       try
       {
          //m_str is a CString in your class
          *pbstr = m_str.AllocSysString( );
          }
       catch (...)
       {
          return E_OUTOFMEMORY;
       }
    
    // The client is now responsible for freeing pbstr.
    return( S_OK );
    }
    //...







[최초 등록일: ]
[최종 수정일: 6/24/2024]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 



2025-03-26 08시30분
What are the thread safety requirements of HSTRING and BSTR?
; https://devblogs.microsoft.com/oldnewthing/20250312-00/?p=110960

BSTR의 경우 Write에 해당하는 Sys­Re­Alloc­String이 있으므로 Sys­Get­String­Len 등의 Read 관련 함수를 스레드에 걸쳐 사용하는 것은 주의해야 함.

반면 HSTRING은 immutable이라 Write 동작이 없으므로 thread-safe.
정성태

[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13964정성태7/10/2025126닷넷: 2340. C# - Win32 Multimedia Timer 주기파일 다운로드1
13963정성태7/8/2025518VS.NET IDE: 202. Visual Studio 2022 + Copilot 기본 사용법
13962정성태7/7/2025631스크립트: 79. 파이썬 - onnxruntime_genai에서 지원하지 않는 모델 사용
13961정성태7/5/2025708디버깅 기술: 222. WinDbg 분석 사례 - IISreset 시점에 w3wp.exe의 crash 발생
13960정성태7/3/2025787개발 환경 구성: 752. ProcDump - C/C++ 예외 코드 필터를 지정한 덤프 생성
13959정성태6/25/20251333오류 유형: 966. Ubuntu - ping: connect: Network is unreachable
13958정성태6/21/20251723닷넷: 2339. C# - Phi-4-multimodal 모델의 GPU 가속 방법 (ORT 사용)파일 다운로드1
13957정성태6/20/20251497닷넷: 2338. C# / Foundry Local - Phi-4-multimodal 모델을 사용하는 방법
13956정성태6/19/20251671개발 환경 구성: 751. Triton Inference Server의 Python Backend 프로세스
13955정성태6/18/20251790오류 유형: 965. Hugging Face 모델 다운로드 시 "requests.exceptions.HTTPError: 401 Client Error: Unauthorized for url: ..." 오류
13954정성태6/18/20251626닷넷: 2337. C# - Hugging Face에 공개된 LLM 모델을 Foundry Local에서 사용하는 방법파일 다운로드1
13953정성태6/16/20251449스크립트: 78. 파이썬 - 소스 코드의 파일 경로를 지정한 모듈 로드
13952정성태6/15/20251784닷넷: 2336. C# - IValueTaskSource로 인해 주의가 필요한 ValueTask 호출파일 다운로드1
13951정성태6/15/20251642오류 유형: 964. Outlook - 일정이 "You cannot make changes to contents of this read-only folder." 오류 메시지로 삭제가 안 되는 경우
13950정성태6/12/20252155닷넷: 2335. C# - 간단하게 구현해 보는 IValueTaskSource 예제파일 다운로드1
13949정성태6/11/20251847오류 유형: 963. SignTool - "Error: SignerSign() failed." (-2146869243/0x80096005)
13948정성태6/10/20251462오류 유형: 962. 파이썬 - Linux 환경 + TCP 서버 소켓을 사용하는 프로세스 종료 후 재실행하는 경우 "OSError: [Errno 98] Address already in use" 오류 발생
13947정성태6/9/20251932개발 환경 구성: 750. 파이썬 - Azure App Service에 응용 프로그램 배포 후의 환경
13946정성태6/9/20252045개발 환경 구성: 749. 파이썬 - Azure App Service에 응용 프로그램 배포하기 전의 환경
13945정성태6/7/20251830오류 유형: 961. 파이썬 + conda - mysqlclient 사용 시 "NameError: name '_mysql' is not defined" 에러
13944정성태6/7/20255576오류 유형: 960. The trust relationship between this workstation and the primary domain failed. - 네 번째 이야기
13943정성태6/6/20252248개발 환경 구성: 748. Windows + Foundry Local - 로컬에서 AI 모델 활용 [1]
13942정성태6/5/20251742오류 유형: 959. winget 설치 시 "0x80d02002 : unknown error"
13941정성태6/2/20251727닷넷: 2334. C# - cpuid 명령어를 이용한 CPU 제조사 문자열 가져오기파일 다운로드1
13940정성태6/1/20252033C/C++: 188. C++의 32비트 + Release 어셈블리 코드를 .NET으로 포팅할 때 주의할 점파일 다운로드1
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...