Partilhar via


Método ComPtr::CopyTo

Copia o atual ou para a interface especificada associada a este ComPtr especificado para o ponteiro.

HRESULT CopyTo(
   _Deref_out_ InterfaceType** ptr
);

HRESULT CopyTo(
   REFIID riid,
   _Deref_out_ void** ptr
) const;
template<
   typename U
>

HRESULT CopyTo(
   _Deref_out_ U** ptr
) const;

Parâmetros

  • U
    Um nome de tipo.

  • ptr
    Quando esta operação concluir, um ponteiro para a interface solicitada.

  • riid
    Uma ID de interface

Valor de retorno

S_OK se bem-sucedido; caso contrário, um HRESULT que indica como a operação implícita de QueryInterface falhou.

Comentários

A primeira função retorna uma cópia de um ponteiro para a interface associada a este ComPtr. Esta função sempre retorna S_OK.

A segunda função executa uma operação de QueryInterface na interface associada a este ComPtr para a interface especificada pelo parâmetro de riid .

A terceira função executa uma operação de QueryInterface na interface associada a este ComPtr para a interface subjacente do parâmetro de U .

Requisitos

Cabeçalho: client.h

Namespace: Microsoft::WRL

Consulte também

Referência

Classe ComPtr