次の方法で共有


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

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

関連項目

文字列 (ATL/MFC)
CStringT::AllocSysString
SysAllocString
SysFreeString