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 오류 코드를 반환합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional, Windows XP [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows 2000 Server, Windows Server 2003 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | shlwapi.h |
DLL | Shlwapi.dll(버전 5.0 이상) |