Freigeben über


ComPtr::CopyTo-Methode

Kopiert die aktuelle oder die angegebene Schnittstelle, die diesem ComPtr dem angegebenen Zeiger zugeordnet sind.

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;

Parameter

  • U
    Ein Typname.

  • ptr
    Wenn dieser Vorgang abgeschlossen ist, ein Zeiger auf die angeforderte Schnittstelle.

  • riid
    Eine Schnittstelle ID.

Rückgabewert

S_OK, wenn erfolgreich; Andernfalls HRESULT warum der implizite fehlgeschlagen QueryInterface-Vorgang angibt.

Hinweise

Die erste Funktion gibt eine Kopie eines Zeigers auf die Schnittstelle zurück, die diesem ComPtr zugeordnet ist.Diese Funktion gibt immer S_OK zurück.

Die zweite Funktion führt einen QueryInterface-Vorgang für die Schnittstelle aus, die diesem ComPtr für die Schnittstelle zugeordnet ist, die durch den riid-Parameter angegeben wird.

Die dritte Funktion führt einen QueryInterface-Vorgang für die Schnittstelle aus, die diesem ComPtr für die zugrunde liegende Schnittstelle des U-Parameters zugeordnet ist.

Anforderungen

Header: client.h

Namespace: Microsoft::WRL

Siehe auch

Referenz

ComPtr-Klasse