IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) 메서드

정의

데이터 개체와 권고 싱크 간에 연결을 만듭니다. 이 메서드는 권고 싱크를 지원 하 고 개체의 데이터 변경 내용에 대 한 알림을 권고 싱크를 사용 하는 개체에 의해 호출 됩니다.

public:
 int DAdvise(System::Runtime::InteropServices::ComTypes::FORMATETC % pFormatetc, System::Runtime::InteropServices::ComTypes::ADVF advf, System::Runtime::InteropServices::ComTypes::IAdviseSink ^ adviseSink, [Runtime::InteropServices::Out] int % connection);
public int DAdvise(ref System.Runtime.InteropServices.ComTypes.FORMATETC pFormatetc, System.Runtime.InteropServices.ComTypes.ADVF advf, System.Runtime.InteropServices.ComTypes.IAdviseSink adviseSink, out int connection);
abstract member DAdvise : FORMATETC * System.Runtime.InteropServices.ComTypes.ADVF * System.Runtime.InteropServices.ComTypes.IAdviseSink * int -> int
Public Function DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, adviseSink As IAdviseSink, ByRef connection As Integer) As Integer

매개 변수

pFormatetc
FORMATETC

FORMATETC 참조로 전달되는 구조체로, 향후 알림에 사용할 형식, 대상 디바이스, 측면 및 매체를 정의합니다.

advf
ADVF

ADVF 권고 연결을 제어하기 위한 플래그 그룹을 지정하는 값 중 하나입니다.

adviseSink
IAdviseSink

변경 알림을 받을 권고 싱크의 인터페이스에 대한 포인터 IAdviseSink 입니다.

connection
Int32

이 메서드가 반환되면 이 연결을 식별하는 DWORD 토큰에 대한 포인터를 포함합니다. 나중에 이 토큰을 사용하여 해당 토큰을 전달하여 권고 연결을 삭제할 DUnadvise(Int32)수 있습니다. 이 값이 0이면 연결이 설정되지 않았습니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.

반품

이 메서드는 E_INVALIDARG, E_UNEXPECTED 및 E_OUTOFMEMORY 표준 반환 값과 다음을 지원합니다.

설명
S_ok 권고 연결이 만들어졌습니다.
E_notimpl 이 메서드는 데이터 개체에서 구현되지 않습니다.
DV_E_LINDEX 에 잘못된 lindex값이 있습니다. 현재는 -1만 지원됩니다.
DV_E_FORMATETC 매개 변수에 잘못된 값이 있습니다 pFormatetc .
OLE_E_ADVISENOTSUPPORTED 데이터 개체는 변경 알림을 지원하지 않습니다.

설명

자세한 내용은 IDataObject::D Advise 메서드를 참조하세요.

적용 대상