다음을 통해 공유


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

정의

데이터 개체와 advise 싱크 간의 연결을 만듭니다. 이 메서드는 advise 싱크를 지원하는 개체에 의해 호출되며, advise 싱크가 개체의 데이터 변경 내용에 대한 알림을 받을 수 있도록 합니다.

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

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

adviseSink
IAdviseSink

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

connection
Int32

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

반환

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

설명
S_OK advise 연결을 만든 경우
E_NOTIMPL 이 메서드가 데이터 개체에 구현되지 않은 경우
DV_E_LINDEX lindex의 값이 잘못된 경우(현재 -1만 지원됨)
DV_E_FORMATETC pFormatetc 매개 변수의 값이 잘못된 경우
OLE_E_ADVISENOTSUPPORTED 데이터 개체에서 변경 알림을 지원하지 않는 경우

설명

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

적용 대상