Partager via


ComPtr::CopyTo, méthode

Copie l'interface actuelle ou spécifiée associée à ce ComPtr vers le pointeur spécifié.

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;

Paramètres

  • U
    Nom de type.

  • ptr
    Lorsque cette opération se termine, un pointeur vers l'interface demandée.

  • riid
    Un ID d'interface.

Valeur de retour

S_OK si l'opération a réussi ; sinon, un HRESULT indiquant pourquoi l'opération implicite de QueryInterface a échoué.

Remarques

La première fonction retourne une copie d'un pointeur vers l'interface associée à ce ComPtr. Cette fonction retourne toujours S_OK.

La deuxième fonction effectue une opération de QueryInterface sur l'interface associée à ce ComPtr pour l'interface spécifiée par le paramètre riid.

La troisième fonction effectue une opération de QueryInterface sur l'interface associée à ce ComPtr pour l'interface sous-jacente du paramètre U.

Configuration requise

En-tête : client.h

Espace de noms : Microsoft::WRL

Voir aussi

Référence

ComPtr, classe