次の方法で共有


BSTR 用のメモリの割り当てと解放

更新 : 2007 年 11 月

BSTR を作成してそれらを COM オブジェクト間で渡すときは、使用するメモリの扱いに注意してメモリ リークを回避する必要があります。BSTR がインターフェイス内だけで使用される場合は、使い終わったらメモリを解放する必要があります。一方、BSTR がインターフェイスの外部に渡される場合は、受け取り側のオブジェクトがメモリを管理します。

一般に、BSTR に対するメモリの割り当てと解放の規則は次のとおりです。

  • BSTR 引数を要求する関数を呼び出す場合は、呼び出す前に BSTR のメモリを割り当て、呼び出し後に解放する必要があります。次に例を示します。

    HRESULT CMyWebBrowser::put_StatusText(BSTR bstr)
    
    // shows using the Win32 function 
    // to allocate memory for the string: 
    BSTR bstrStatus = ::SysAllocString(L"Some text");
    if (bstrStatus != NULL)
    {
       pBrowser->put_StatusText(bstrStatus);
       // Free the string:
       ::SysFreeString(bstrStatus);
    }
    
  • BSTR を返す関数を呼び出す場合は、文字列を自身で解放する必要があります。次に例を示します。

    HRESULT CMyWebBrowser::get_StatusText(BSTR* pbstr)
    
    BSTR bstrStatus;
    pBrowser->get_StatusText(&bstrStatus);
    
    // shows using the Win32 function 
    // to free the memory for the string: 
    ::SysFreeString(bstrStatus);
    
  • BSTR を返す関数を実装する場合は、文字列を割り当てますが、解放はしません。受け取り側の関数がメモリを解放します。次に例を示します。

    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);
    }
    

参照

参照

CStringT::AllocSysString

SysAllocString

SysFreeString

その他の技術情報

文字列 (ATL/MFC)