ptr::CreateInstance

Article
03/04/2013

Crée une instance d'un objet COM dans 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
);

Paramètres

progid
Une chaîne d' ProgID .
pouter
Pointeur vers l'interface d'IUnknown de l'objet global (l'IUnknown contrôle).Si pouter n'est pas spécifié, NULL est utilisé.
cls_context
Contexte dans lequel le code qui gère l'objet nouvellement créé s'exécutera.Les valeurs sont récupérées l'énumération d' CLSCTX .Si cls_context n'est pas spécifié, la valeur CLSCTX_ALL est utilisée.
rclsid
CLSID associé aux données et le code qui seront utilisés pour créer l'objet.

Exceptions

Si com::ptr possède déjà une référence à un objet COM, CreateInstance lève InvalidOperationException.

Appels de cette fonction CoCreateInstance et utilise ThrowExceptionForHR de convertir une erreur HRESULT à une exception appropriée.

Notes

CreateInstance utilise CoCreateInstance pour créer une nouvelle instance de l'objet spécifié, identifiée d'un progid ou d'un CLSID.com::ptr référence l'objet nouvellement créé et libère automatiquement toutes les références détenues en cas de destruction.

Exemple

Cet exemple implémente une classe CLR qui utilise com::ptr pour encapsuler son objet d' IXMLDOMDocument de membre privé.Les constructeurs de classe utilisent deux formes différentes d' CreateInstance pour créer l'objet document d'un progid ou CLSID plus un 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);   
   }
}

Configuration requise

fichier d'en-tête<msclr \ COM \ ptr.h>

Msclr::com deEspace de noms

Voir aussi

Autres ressources

membres PTR

Partager via