分配和释放 BSTR 的内存

本文档已存档，并且将不进行维护。

分配和释放 BSTR 的内存

Visual Studio .NET 2003                 

转自：

https://msdn.microsoft.com/zh-cn/library/cc485262(v=vs.71).aspx 

当创建 BSTR 并在 COM 对象之间传递它们时，必须小心地处理它们所使用的内存以避免内存泄漏。当 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.js调用ocx里的方法时,ocx里的方法不需要释放
  return( S_OK );
  }
  //...