CLR クラスのメンバーとして使用できる COM オブジェクトのラッパー。ラッパーは、デストラクターが呼び出されると、オブジェクトのすべての所有されている参照を解放する COM オブジェクトの有効期間管理を自動化します。CComPtr クラスに似ています。
template<class _interface_type>
ref class ptr;
パラメーター
- _interface_type
COM インターフェイス。
解説
さまざまな COM タスクを簡略化し、有効期間管理を自動化するために、 com::ptr がとしてローカル関数の変数使用できます。
com::ptr は、関数パラメーターとして直接使用することはできません; 参照演算子の追跡 (C++ コンポーネント拡張) か オブジェクト演算子 (^) へのハンドル (C++ コンポーネント拡張) を使用してください。
com::ptr は、関数から直接戻すことはできません; ハンドルを使用してください。
使用例
この例では、プライベート メンバー IXMLDOMDocument オブジェクトをラップするために com::ptr を使用する CLR クラスを実装します。呼び出しのクラスの結果のパブリック メソッドが含まれている IXMLDOMDocument を呼び出して作成します。サンプルは、 XML ドキュメントのインスタンスを作成し、単純な XML との塗りつぶし、コンソールに XML を印刷するために解析されたドキュメント ツリーのノードの単純ウォークをします。
// comptr.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);
}
void LoadXml(String^ xml) {
pin_ptr<const wchar_t> pinnedXml = PtrToStringChars(xml);
BSTR bstr = NULL;
try {
// load some XML into the document
bstr = ::SysAllocString(pinnedXml);
if (NULL == bstr) {
throw gcnew OutOfMemoryException;
}
VARIANT_BOOL bIsSuccessful = false;
// use operator -> to call IXMODOMDocument member function
Marshal::ThrowExceptionForHR(m_ptrDoc->loadXML(bstr, &bIsSuccessful));
}
finally {
::SysFreeString(bstr);
}
}
// simplified function to write just the first xml node to the console
void WriteXml() {
IXMLDOMNode* pNode = NULL;
try {
// the first child of the document is the first real xml node
Marshal::ThrowExceptionForHR(m_ptrDoc->get_firstChild(&pNode));
if (NULL != pNode) {
WriteNode(pNode);
}
}
finally {
if (NULL != pNode) {
pNode->Release();
}
}
}
// note that the destructor will call the com::ptr destructor
// and automatically release the reference to the COM object
private:
// simplified function that only writes the node
void WriteNode(IXMLDOMNode* pNode) {
BSTR bstr = NULL;
try {
// write out the name and text properties
Marshal::ThrowExceptionForHR(pNode->get_nodeName(&bstr));
String^ strName = gcnew String(bstr);
Console::Write("<{0}>", strName);
::SysFreeString(bstr);
bstr = NULL;
Marshal::ThrowExceptionForHR(pNode->get_text(&bstr));
Console::Write(gcnew String(bstr));
::SysFreeString(bstr);
bstr = NULL;
Console::WriteLine("</{0}>", strName);
}
finally {
::SysFreeString(bstr);
}
}
com::ptr<IXMLDOMDocument> m_ptrDoc;
};
// use the ref class to handle an XML DOM Document object
int main() {
try {
// create the class from a progid string
XmlDocument doc("Msxml2.DOMDocument.3.0");
// stream some xml into the document
doc.LoadXml("<word>persnickety</word>");
// write the document to the console
doc.WriteXml();
}
catch (Exception^ e) {
Console::WriteLine(e);
}
}
必要条件
ヘッダー ファイル <msclr\com\ptr.h>
名前空間 msclr::com