ptr::operator=

com::ptrに COM オブジェクトを接続します。

ptr<_interface_type> % operator=(
   _interface_type * _right
);

パラメーター

• _right
  接続する COM インターフェイス ポインター。

戻り値

com::ptrトラッキング参照。

例外

com::ptr が COM オブジェクトへの参照を既に所有する場合、operator= は InvalidOperationException をスローします。

解説

com::ptr に COM オブジェクトを割り当てる COM オブジェクトを参照しますが、呼び出し元の参照を解放しません。

この演算子は Attachと同じ効果があります。

使用例

この例では、プライベート メンバー IXMLDOMDocument オブジェクトをラップするために com::ptr を使用する CLR クラスを実装します。の ReplaceDocument のメンバー関数の最初の呼び出し Release は、前に作成したオブジェクトを新しいドキュメントのオブジェクトを接続するに operator= を使用します。

// comptr_op_assign.cpp
// compile with: /clr /link msxml2.lib
#include <msxml2.h>
#include <msclr\com\ptr.h>

#import <msxml3.dll> raw_interfaces_only

using namespace System;
using namespace System::Runtime::InteropServices;
using namespace msclr;

// a ref class that uses a com::ptr to contain an 
// IXMLDOMDocument object
ref class XmlDocument {
public:
   // construct the internal com::ptr with a null interface
   // and use CreateInstance to fill it
   XmlDocument(String^ progid) {
      m_ptrDoc.CreateInstance(progid);   
   }

   // replace currently held COM object with another one
   void ReplaceDocument(IXMLDOMDocument* pDoc) {
      // release current document object
      m_ptrDoc.Release();
      // attach the new document object
      m_ptrDoc = pDoc;
   }

   // note that the destructor will call the com::ptr destructor
   // and automatically release the reference to the COM object

private:
   com::ptr<IXMLDOMDocument> m_ptrDoc;
};

// unmanaged function that creates a raw XML DOM Document object
IXMLDOMDocument* CreateDocument() {
   IXMLDOMDocument* pDoc = NULL;
   Marshal::ThrowExceptionForHR(CoCreateInstance(CLSID_DOMDocument30, NULL,
      CLSCTX_INPROC_SERVER, IID_IXMLDOMDocument, (void**)&pDoc));
   return pDoc;
}


// use the ref class to handle an XML DOM Document object
int main() {
   IXMLDOMDocument* pDoc = NULL;

   try {
      // create the class from a progid string
      XmlDocument doc("Msxml2.DOMDocument.3.0");

      // get another document object from unmanaged function and
      // store it in place of the one held by the ref class
      pDoc = CreateDocument();
      doc.ReplaceDocument(pDoc);
      // no further need for raw object reference
      pDoc->Release();
      pDoc = NULL;
   }
   catch (Exception^ e) {
      Console::WriteLine(e);   
   }
   finally {
      if (NULL != pDoc) {
         pDoc->Release();
      }
   }
}

必要条件

ヘッダー ファイル <msclr\com\ptr.h>

名前空間 msclr::com

参照

関連項目

ptr::Attach

ptr::Detach

ptr::Release

その他の技術情報

ptr Members