Freigeben über

ConnectToConnectionPoint-Funktion (shlwapi.h)

  • Artikel

[Diese Funktion ist über Windows XP und Windows Server 2003 verfügbar. In nachfolgenden Windows-Versionen ist sie möglicherweise geändert oder nicht verfügbar.]

Stellt eine Verbindung zwischen der Senke eines Clients und einem Verbindungspunktcontainer her oder beendet sie.

Syntax

LWSTDAPI ConnectToConnectionPoint(
  [in, optional]  IUnknown         *punk,
  [in]            REFIID           riidEvent,
                  BOOL             fConnect,
  [in]            IUnknown         *punkTarget,
  [out]           DWORD            *pdwCookie,
  [out, optional] IConnectionPoint **ppcpOut
);

Parameter

[in, optional] punk

Typ: IUnknown*

Ein Zeiger auf die IUnknown-Schnittstelle des Objekts, das mit dem Verbindungspunktcontainer verbunden werden soll. Wenn Sie fConnect auf FALSE festlegen, um anzugeben, dass Sie das Objekt trennen, wird dieser Parameter ignoriert und kann auf NULL festgelegt werden.

[in] riidEvent

Typ: REFIID

Die IID der Schnittstelle im Verbindungspunktcontainer, dessen Verbindungspunktobjekt angefordert wird.

fConnect

Typ: BOOL

TRUE , wenn eine Verbindung hergestellt wird; FALSE , wenn eine Verbindung unterbrochen wird.

[in] punkTarget

Typ: IUnknown*

Ein Zeiger auf die IUnknown-Schnittstelle des Verbindungspunktcontainers.

[out] pdwCookie

Typ: DWORD*

Ein Verbindungstoken. Wenn Sie fConnect auf TRUE festlegen, um eine neue Verbindung herzustellen, empfängt dieser Parameter ein Token, das die Verbindung eindeutig identifiziert. Wenn Sie fConnect auf FALSE festlegen, um eine Verbindung zu unterbrechen, muss dieser Parameter auf das Token verweisen, das Sie beim Aufrufen von ConnectToConnectionPoint erhalten haben, um die Verbindung herzustellen.

[out, optional] ppcpOut

Typ: IConnectionPoint**

Ein Zeiger auf die IConnectionPoint-Schnittstelle des Verbindungspunktcontainers, wenn der Vorgang erfolgreich war. Die aufrufende Anwendung muss diesen Zeiger freigeben, wenn er nicht mehr benötigt wird. Wenn die Anforderung nicht erfolgreich ist, erhält der Zeiger NULL. Dieser Parameter ist optional und kann NULL sein.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server, Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlwapi.h
DLL Shlwapi.dll (Version 5.0 oder höher)