IConnectionPointContainer::FindConnectionPoint-Methode (ocidl.h)

  • Artikel

Gibt einen Zeiger auf die IConnectionPoint-Schnittstelle eines Verbindungspunkts für eine angegebene IID zurück, wenn dieser IID eine unterstützte ausgehende Schnittstelle beschreibt.

Syntax

HRESULT FindConnectionPoint(
  [in]  REFIID           riid,
  [out] IConnectionPoint **ppCP
);

Parameter

[in] riid

Schnittstellenbezeichner der ausgehenden Schnittstelle, deren Verbindungspunktobjekt angefordert wird.

[out] ppCP

Die Adresse einer IConnectionPoint-Schnittstellenzeigervariable , die den Zeiger auf den Verbindungspunkt empfängt, der die riid-Schnittstelle unterstützt. Wenn ein Fehler auftritt, legt die Implementierung den Wert auf NULL fest.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_OUTOFMEMORY und E_UNEXPECTED sowie die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich abgeschlossen.
E_POINTER
 Die Adresse in ppCP ist ungültig. Es kann z. B. NULL sein.
CONNECT_E_NOCONNECTION
 Dieses zu verbindende Objekt unterstützt nicht die ausgehende Schnittstelle, die von riid angegeben wird.

Hinweise

Diese Methode ist die QueryInterface-Entsprechung für die ausgehenden Schnittstellen eines Objekts, wobei die ausgehende Schnittstelle mit riid angegeben wird und bei dem der zurückgegebene Schnittstellenzeiger immer der eines Verbindungspunkts ist.

Hinweise für Anrufer

Wenn der Aufruf erfolgreich ist, ist der Aufrufer für das Freigeben des Verbindungspunkts verantwortlich, indem er Release aufruft, wenn der Verbindungspunkt nicht mehr benötigt wird.

Hinweise zu Implementierern

E_NOTIMPL ist als Rückgabewert für diese Methode nicht zulässig. Jede Implementierung von IConnectionPointContainer muss diese Methode für die ausgehenden Schnittstellen des verbindenden Objekts implementieren.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile ocidl.h

Weitere Informationen

IConnectionPoint

IConnectionPointContainer