Compartilhar via


CComObject::CreateInstance

Essa função estática permite que você crie um novo objeto de CComObject<Base> , sem a sobrecarga de CoCreateInstance.

static HRESULT WINAPI CreateInstance(
   CComObject< Base >** pp 
);

Parâmetros

  • pp
    [out] um ponteiro à um ponteiro de CComObject<Base> .Se for mal sucedido, CreateInstancepp é definido como NULO.

Valor de retorno

Um valor padrão de HRESULT .

Comentários

O objeto retornado tem uma contagem de referência de zero, para que a chamada AddRef imediatamente, então o uso Versão liberar a referência no ponteiro do objeto quando você terminar.

Se você não precisa de acesso direto ao objeto, mas ainda o deseja criar um novo objeto sem a sobrecarga de CoCreateInstance, use CComCoClass::CreateInstance em vez de isso.

Exemplo

class ATL_NO_VTABLE CMyCircle :
   public CComObjectRootEx<CComSingleThreadModel>,
   public CComCoClass<CMyCircle, &CLSID_MyCircle>,
   public IDispatchImpl<IMyCircle, &IID_IMyCircle, &LIBID_NVC_ATL_COMLib, /*wMajor =*/ 1, /*wMinor =*/ 0>
{
public:
   CMyCircle()
   {
   }

DECLARE_REGISTRY_RESOURCEID(IDR_MYCIRCLE)

DECLARE_NOT_AGGREGATABLE(CMyCircle)

BEGIN_COM_MAP(CMyCircle)
   COM_INTERFACE_ENTRY(IMyCircle)
   COM_INTERFACE_ENTRY(IDispatch)
END_COM_MAP()



   DECLARE_PROTECT_FINAL_CONSTRUCT()

   HRESULT FinalConstruct()
   {
      return S_OK;
   }

   void FinalRelease()
   {
   }

public:

public:
   STDMETHOD(get_XCenter)(double* pVal);
};
// Create a local instance of COM object CMyCircle.
double x;
CComObject<CMyCircle>* pCircle;
HRESULT hRes = CComObject<CMyCircle>::CreateInstance(&pCircle);
ATLASSERT(SUCCEEDED(hRes));

// Increment reference count immediately
pCircle->AddRef();

// Access method of COM object
hRes = pCircle->get_XCenter(&x);

// Decrement reference count when done
pCircle->Release();
pCircle = NULL;

Requisitos

Cabeçalho: atlcom.h

Consulte também

Referência

Classe de CComObject