Compartilhar via


_com_ptr_t::CreateInstance

Específicos do Microsoft

Cria uma nova instância de um objeto que recebe um CLSID ou ProgID.

HRESULT CreateInstance(
   const CLSID& rclsid,
   IUnknown* pOuter=NULL,
   DWORD dwClsContext = CLSCTX_ALL 
) throw( );
HRESULT CreateInstance(
   LPCWSTR clsidString,
   IUnknown* pOuter=NULL,
   DWORD dwClsContext = CLSCTX_ALL 
) throw( );
HRESULT CreateInstance(
   LPCSTR clsidStringA,
   IUnknown* pOuter=NULL,
   DWORD dwClsContext = CLSCTX_ALL 
) throw( );

Parâmetros

  • rclsid
    O CLSID de um objeto.

  • clsidString
    Uma seqüência de caracteres Unicode que mantém um um CLSID (começando com "{") ou um ProgID.

  • clsidStringA
    Uma seqüência de caracteres multibyte, usando a página de código ANSI, que contém tanto um CLSID (começando com "{") ou um ProgID.

  • dwClsContext
    Contexto para a execução de código executável.

  • pOuter
    Externo desconhecido para agregação.

Comentários

Essas funções membro chamam CoCreateInstance para criar um novo objeto COM e, em seguida, consultas para o tipo de interface desse ponteiro inteligente.O ponteiro resultante é encapsulado nisso _com_ptr_t objeto.Versão é chamado decrementar a contagem de referência para o ponteiro encapsulado anteriormente.Esta rotina retorna o HRESULT para indicar sucesso ou falha.

  • CreateInstance ( rclsid**,dwClsContext)** cria uma nova instância em execução de um objeto que recebe um CLSID.

  • CreateInstance ( clsidString**,dwClsContext)** cria uma nova instância em execução de um objeto, dada uma seqüência de caracteres Unicode que mantém um um CLSID (começando com "{") ou um ProgID.

  • CreateInstance ( clsidStringA**,dwClsContext)** cria uma nova instância em execução de um objeto, dada uma seqüência de caracteres multibyte que mantém um um CLSID (começando com "{") ou um ProgID.Chamadas MultiByteToWideChar, que faz supor que a seqüência está na página de código ANSI em vez de uma página de código OEM.

Específicos do Microsoft final

Consulte também

Referência

com_ptr_t classe