IConnectionPoint::GetConnectionInterface-Methode (ocidl.h)

Ruft die IID der ausgehenden Schnittstelle ab, die von diesem Verbindungspunkt verwaltet wird.

Syntax

HRESULT GetConnectionInterface(
  [out] IID *pIID
);

Parameter

[out] pIID

Ein Zeiger auf den Bezeichner der ausgehenden Schnittstelle, die von diesem Verbindungspunkt verwaltet wird.

Rückgabewert

Diese Methode kann den Standardrücklaufwert E_UNEXPECTED sowie die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
Die Variable pIID des Aufrufers enthält den Bezeichner der ausgehenden Schnittstelle, die von diesem Verbindungspunkt verwaltet wird.
E_POINTER
Die Adresse in pIID ist ungültig. Beispielsweise kann es NULL sein.

Bemerkungen

Mithilfe der IEnumConnectionPoints-Schnittstelle kann ein Client einen Zeiger auf die IConnectionPoint-Schnittstelle abrufen. Mit diesem Zeiger und der GetConnectionInterface-Methode kann der Client die IID der einzelnen Verbindungspunkte aufzählen. Die von dieser Methode zurückgegebene IID muss den Aufrufer für den Zugriff auf diesen Verbindungspunkt über IConnectionPointContainer::FindConnectionPoint aktivieren.

Hinweise zu Implementierungen

Diese Methode muss in jedem Verbindungspunkt implementiert werden; E_NOTIMPL ist kein akzeptabler Rückgabewert.

Anforderungen

   
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