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

아티클
03/01/2024

개체에 대해 현재 설정된 권고 연결을 열거하는 데 사용할 수 있는 열거자를 만듭니다.

구문

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

매개 변수

[out] ppenumAdvise

새 열거자에 대한 인터페이스 포인터를 수신하는 IEnumSTATDATA 포인터 변수에 대한 포인터입니다. 이 매개 변수가 NULL이면 현재 개체에 대한 권고 연결이 없거나 오류가 발생했습니다. 조언 보유자는 이 메서드가 제공하는 IEnumSTATDATA 포인터에 대한 참조 횟수를 증분해야 합니다. 포인터로 완료되면 IUnknown::Release 를 호출하는 것은 호출자의 책임입니다.

반환 값

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

반환 코드	설명
E_FAIL	열거형 작업이 실패했습니다.
E_NOTIMPL	IOleAdviseHolder::EnumAdvise 는 구현되지 않습니다.

설명

IOleAdviseHolder::EnumAdvise 는 개체의 설정된 권고 연결을 열거하는 데 사용할 수 있는 열거자를 만듭니다. 메서드는 이 열거자의 IEnumSTATDATA 인터페이스에 대한 포인터를 제공합니다. 각 연결에 대한 권고 연결 정보는 STATDATA 구조에 저장되며 열거자는 이러한 구조를 열거할 수 있어야 합니다.

이 메서드의 경우 관련 구조체 멤버는 pAdvise 및 dwConnection뿐입니다. 다른 멤버에는 데이터 권고 정보가 포함됩니다. 열거형 메서드를 호출하고 열거형이 진행 중인 동안 열거할 항목에 대한 권고 연결을 등록하거나 해지하는 효과는 정의되지 않습니다.

요구 사항

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