CComBSTR::Attach

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

CComBSTR::m_str メンバの値としてパラメータ src を設定して、BSTR を CComBSTR オブジェクトにアタッチします。

void Attach(
   BSTR src 
) throw( );

パラメータ

src
[入力] オブジェクトにアタッチする BSTR。

解説

通常のワイド文字列をこのメソッドに渡さないでください。コンパイラでエラーをキャッチできないため、ランタイムエラーが発生します。

メモ :
m_str が NULL 以外の場合は、このメソッドによってアサートされます。

使用例

// STDMETHOD(BSTRToUpper)(/*[in, out]*/ BSTR bstrConv);
STDMETHODIMP InplaceBSTRToUpper(BSTR bstrConv)
{
   // Assign bstrConv to m_str member of CComBSTR
   CComBSTR bstrTemp;
   bstrTemp.Attach(bstrConv); 

   // Make sure BSTR is not NULL string
   if (!bstrTemp)
        return E_POINTER;

   // Make string uppercase 
   HRESULT hr;
   hr = bstrTemp.ToUpper();
   if (hr != S_OK)
       return hr;

   // Set m_str to NULL, so the BSTR is not freed
   bstrTemp.Detach(); 

   return S_OK; 
}