IOleObject::EnumAdvise 메서드(oleidl.h)
개체에 등록된 권고 연결을 열거하는 데 사용할 수 있는 열거자에 대한 포인터를 검색하므로 컨테이너는 종료하기 전에 해제할 항목을 알 수 있습니다.
구문
HRESULT EnumAdvise(
[out] IEnumSTATDATA **ppenumAdvise
);
매개 변수
[out] ppenumAdvise
열거자 개체에 대한 인터페이스 포인터를 수신하는 IEnumSTATDATA 포인터 변수의 주소입니다. 개체에 권고 연결이 없거나 오류가 발생하면 구현에서 ppenumAdvise 를 NULL로 설정해야 합니다. 개체가 IOleObject::EnumAdvise에 대한 호출을 성공적으로 수신할 때마다 ppenumAdvise에서 참조 횟수를 늘려야 합니다. ppenumAdvise를 사용하여 릴리스를 호출하는 것은 호출자의 책임입니다.
반환 값
이 메서드는 성공에 대한 S_OK 반환합니다. 다른 가능한 반환 값은 다음과 같습니다.
| 반환 코드 | 설명 |
|---|---|
|
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 |