PTR::CreateInstance

Artigo
02/25/2013

Cria uma instância de um objeto COM em um com::ptr.

void CreateInstance(
   System::String ^ progid,
   LPUNKNOWN pouter,
   DWORD cls_context
);
void CreateInstance(
   System::String ^ progid,
   LPUNKNOWN pouter
);
void CreateInstance(
   System::String ^ progid
);
void CreateInstance(
   const wchar_t * progid,
   LPUNKNOWN pouter,
   DWORD cls_context
);
void CreateInstance(
   const wchar_t * progid,
   LPUNKNOWN pouter
);
void CreateInstance(
   const wchar_t * progid
);
void CreateInstance(
   REFCLSID rclsid,
   LPUNKNOWN pouter,
   DWORD cls_context
);
void CreateInstance(
   REFCLSID rclsid,
   LPUNKNOWN pouter
);
void CreateInstance(
   REFCLSID rclsid
);

Parâmetros

progid
A ProgID string.
pouter
Ponteiro para a interface de IUnknown do objeto agregado (o controle IUnknown).Se pouter não for especificado, NULL é usado.
cls_context
Contexto no qual o código que gerencia o objeto recém-criado será executado.Os valores são obtidos da CLSCTX enumeração.Se cls_context não for especificado, o valor CLSCTX_ALL é usado.
rclsid
CLSIDassociado com os dados e código que será usado para criar o objeto.

Exceções

Se o com::ptr já possui uma referência a um objeto COM, CreateInstance lança InvalidOperationException.

Essa função chama CoCreateInstance e usa ThrowExceptionForHR para converter qualquer erro HRESULT a uma exceção apropriada.

Comentários

CreateInstanceusa CoCreateInstance para criar uma nova instância do objeto especificado, identificado a partir de ProgID ou um CLSID.O com::ptr referências de objeto recém-criado e liberará automaticamente pertencente a todas as referências na destruição.

Exemplo

Este exemplo implementa uma classe CLR que usa um com::ptr para quebrar o seu membro privado IXMLDOMDocument objeto.Os construtores de classe usam duas formas diferentes de CreateInstance para criar o objeto de documento de um ProgID ou de um CLSID mais um CLSCTX.

// comptr_createinstance.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);   
   }
   XmlDocument(REFCLSID clsid, DWORD clsctx) {
      m_ptrDoc.CreateInstance(clsid, NULL, clsctx);
   }

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

// use the ref class to handle an XML DOM Document object
int main() {
   try {
      // create the class from a progid string
      XmlDocument doc1("Msxml2.DOMDocument.3.0");

      // or from a clsid with specific CLSCTX
      XmlDocument doc2(CLSID_DOMDocument30, CLSCTX_INPROC_SERVER);
   }
   catch (Exception^ e) {
      Console::WriteLine(e);   
   }
}

Requisitos

Arquivo de cabeçalho <msclr\com\ptr.h>

Namespace msclr::com

Consulte também

Outros recursos

PTR membros

Partilhar via