Freigeben über


ComPtr::CopyTo-Methode

Kopiert den aktuellen oder die angegebene Schnittstelle, die diesem ComPtr dem angegebenen Zeiger zugeordnet werden.

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 zur angeforderten Schnittstelle.

  • riid
    Eine Schnittstelle ID

Rückgabewert

S_OK, wenn erfolgreich; andernfalls ein HRESULT, das angibt, warum der implizite QueryInterface-Vorgang fehlgeschlagen ist.

Hinweise

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

Die zweite Funktion führt einen QueryInterface-Vorgang auf der Schnittstelle aus, die diesem ComPtr für die Schnittstelle zugeordnet wird, die vom riid-Parameter angegeben wurde.

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

Anforderungen

Header: client.h

Namespace: Microsoft::WRL

Siehe auch

Referenz

ComPtr-Klasse