Функция ConnectToConnectionPoint (shlwapi.h)

[Эта функция доступна через Windows XP и Windows Server 2003. Он может быть изменен или недоступен в последующих версиях Windows.]

Устанавливает или завершает подключение между приемником клиента и контейнером точки подключения.

Синтаксис

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

Параметры

[in, optional] punk

Тип: IUnknown*

Указатель на интерфейс IUnknown объекта, который должен быть подключен к контейнеру точки подключения. Если параметр fConnect имеет значение FALSE , чтобы указать, что вы отключаете объект, этот параметр игнорируется и может иметь значение NULL.

[in] riidEvent

Тип: REFIID

IID интерфейса в контейнере точки подключения, объект точки подключения которого запрашивается.

fConnect

Тип: BOOL

ЗНАЧЕНИЕ TRUE , если установлено подключение; ЗНАЧЕНИЕ FALSE , если соединение не работает.

[in] punkTarget

Тип: IUnknown*

Указатель на интерфейс IUnknown контейнера точки подключения.

[out] pdwCookie

Тип: DWORD*

Маркер подключения. Если параметр fConnect имеет значение TRUE для создания нового подключения, этот параметр получает маркер, который однозначно идентифицирует соединение. Если параметр fConnect имеет значение FALSE для прерывания подключения, этот параметр должен указывать на маркер, полученный при вызове ConnectToConnectionPoint , чтобы установить подключение.

[out, optional] ppcpOut

Тип: IConnectionPoint**

Указатель на интерфейс IConnectionPoint контейнера точки подключения, если операция выполнена успешно. Вызывающее приложение должно освободить этот указатель, если он больше не нужен. Если запрос не выполнен, указатель получает значение NULL. Этот параметр является необязательным и может быть null.

Возвращаемое значение

Тип: HRESULT

Если эта функция выполнена успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Требования