IOleObject::EnumAdvise 메서드(oleidl.h)

개체에 등록된 권고 연결을 열거하는 데 사용할 수 있는 열거자에 대한 포인터를 검색하므로 컨테이너는 종료하기 전에 해제할 항목을 알 수 있습니다.

구문

HRESULT EnumAdvise(
  [out] IEnumSTATDATA **ppenumAdvise
);

매개 변수

[out] ppenumAdvise

열거자 개체에 대한 인터페이스 포인터를 수신하는 IEnumSTATDATA 포인터 변수의 주소입니다. 개체에 권고 연결이 없거나 오류가 발생하면 구현에서 ppenumAdvise 를 NULL로 설정해야 합니다. 개체가 IOleObject::EnumAdvise에 대한 호출을 성공적으로 수신할 때마다 ppenumAdvise에서 참조 횟수를 늘려야 합니다. ppenumAdvise를 사용하여 릴리스를 호출하는 것은 호출자의 책임입니다.

반환 값

이 메서드는 성공에 대한 S_OK 반환합니다. 다른 가능한 반환 값은 다음과 같습니다.

반환 코드	설명
E_NOTIMPL	IOleObject::EnumAdvise 가 구현되지 않았습니다.

설명

IOleObject::EnumAdvise 메서드는 컨테이너가 해당 개체에 대해 등록된 권고 연결을 추적하는 방법을 제공하는 열거자를 제공합니다. 컨테이너는 일반적으로 이 함수를 호출하므로 개체가 닫히기 전에 각 권고 연결을 해제하도록 지시할 수 있습니다.

IOleObject::EnumAdvise를 통해 액세스할 수 있는 열거자는 STATDATA 형식의 항목을 열거합니다. 포인터를 받으면 컨테이너는 STATDATA 를 반복하고 열거된 각 연결에 대해 IOleObject::Unadvise 를 호출할 수 있습니다.

이 함수를 구현하는 일반적인 방법은 호출을 IOleAdviseHolder 인터페이스에 위임하는 것입니다. STATDATA의 pAdvise 및 dwConnection 멤버만 IOleObject::EnumAdvise와 관련이 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	oleidl.h

추가 정보

IOleObject

IOleObject::Advise

IOleObject::Unadvise