ConnectToConnectionPoint-Funktion (shlwapi.h)

[Diese Funktion ist über Windows XP und Windows Server 2003 verfügbar. Sie kann in nachfolgenden Versionen von Windows geändert oder nicht verfügbar sein.]

Stellt eine Verbindung zwischen der Spüle 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
);

Die 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 auf dem 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, empfängt der Zeiger NULL. Dieser Parameter ist optional und kann NULL-werden.

Rückgabewert

Typ: HRESULT-

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

Anforderungen