Classe CComObjectStack

  • Artigo

Essa classe cria um objeto COM temporário e fornece a ele uma implementação estrutural de IUnknown.

Sintaxe

template <class  Base>
class CComObjectStack : public Base

Parâmetros

Base
Sua classe, derivada de CComObjectRoot ou CComObjectRootEx, bem como de qualquer outra interface que você deseja dar suporte no objeto.

Membros

Construtores públicos

Nome Descrição
CComObjectStack::CComObjectStack O construtor .
CComObjectStack::~CComObjectStack O destruidor.

Métodos públicos

Nome Descrição
CComObjectStack::AddRef Retorna zero. No modo de depuração, chama _ASSERTE.
CComObjectStack::QueryInterface Retorna E_NOINTERFACE. No modo de depuração, chama _ASSERTE.
CComObjectStack::Release Retorna zero. No modo de depuração, chama _ASSERTE. ~

Membros de Dados Públicos

Nome Descrição
CComObjectStack::m_hResFinalConstruct Contém o HRESULT retornado durante a construção do objeto CComObjectStack.

Comentários

CComObjectStack é usado para criar um objeto COM temporário e fornecer ao objeto uma implementação estrutural de IUnknown. Normalmente, o objeto é usado como uma variável local dentro de uma função (ou seja, enviada por push para a pilha). Como o objeto é destruído quando a função é concluída, a contagem de referências não é executada para aumentar a eficiência.

O seguinte exemplo mostra como criar um objeto COM usado dentro de uma função:

void MyFunc()
{
   CComObjectStack<CMyClass2> Tempobj;
   //...
}

O objeto Tempobj temporário é enviado por push para a pilha e desaparece automaticamente quando a função é concluída.

Hierarquia de herança

Base

CComObjectStack

Requisitos

Cabeçalho: atlcom.h

CComObjectStack::AddRef

Retorna zero.

STDMETHOD_(ULONG, AddRef)();

Valor de Devolução

Retorna zero.

Comentários

No modo de depuração, chama _ASSERTE.

CComObjectStack::CComObjectStack

O construtor .

CComObjectStack(void* = NULL);

Comentários

Chama FinalConstruct e define m_hResFinalConstruct para o HRESULT retornado por FinalConstruct. Se você não tiver derivado sua classe base do CComObjectRoot, deverá fornecer seu próprio método FinalConstruct. O destruidor chama FinalRelease.

CComObjectStack::~CComObjectStack

O destruidor.

CComObjectStack();

Comentários

Libera todos os recursos alocados e chama FinalRelease.

CComObjectStack::m_hResFinalConstruct

Contém o HRESULT retornado ao chamar FinalConstruct durante a construção do objeto CComObjectStack.

HRESULT    m_hResFinalConstruct;

CComObjectStack::QueryInterface

Retorna E_NOINTERFACE.

HRESULT    QueryInterface(REFIID, void**);

Valor de Devolução

Retorna E_NOINTERFACE.

Comentários

No modo de depuração, chama _ASSERTE.

CComObjectStack::Release

Retorna zero.

STDMETHOD_(ULONG, Release)();

Valor de Devolução

Retorna zero.

Comentários

No modo de depuração, chama _ASSERTE.

Confira também

Classe CComAggObject
Classe CComObject
Classe CComObjectGlobal
Visão geral da classe