Функция 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

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

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 .

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера	Windows 2000 Server, Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	shlwapi.h
DLL	Shlwapi.dll (версия 5.0 или более поздняя)