IMoniker::Enum 메서드(objidl.h)

아티클
03/05/2024

복합 모니커의 구성 요소에 대한 열거자에 대한 포인터를 검색합니다.

구문

HRESULT Enum(
  [in]  BOOL         fForward,
  [out] IEnumMoniker **ppenumMoniker
);

매개 변수

[in] fForward

TRUE이면 모니커를 왼쪽에서 오른쪽으로 열거합니다. FALSE이면 오른쪽에서 왼쪽으로 열거합니다.

[out] ppenumMoniker

모니커의 열거자 개체에 대한 인터페이스 포인터를 수신하는 IEnumMoniker 포인터 변수에 대한 포인터입니다. 성공하면 구현은 열거자 개체에서 AddRef 를 호출해야 합니다. 릴리스를 호출하는 것은 호출자의 책임입니다. 오류가 발생하거나 모니커에 열거 가능한 구성 요소가 없는 경우 구현은 *ppenumMoniker 를 NULL로 설정합니다.

반환 값

이 메서드는 표준 반환 값 E_OUTOFMEMORY, E_UNEXPECTED 및 S_OK 반환할 수 있습니다.

설명

이 메서드는 모니커의 구성 요소를 열거할 수 있는 열거자에 대한 IEnumMoniker 포인터를 제공해야 합니다. 예를 들어 제네릭 복합 모니커에 대한 IMoniker::Enum 메서드의 구현은 복합을 구성하는 개별 모니커를 결정할 수 있는 열거자를 만드는 반면, 파일 모니커의 IMoniker::Enum 메서드는 경로의 각 구성 요소를 나타내는 모니커를 반환하는 열거자를 만듭니다.

발신자에 대한 참고 사항

복합 모니커를 구성하는 구성 요소를 검사하려면 이 메서드를 호출합니다.

구현자에 대한 참고 사항

새 모니커 클래스에 식별 가능한 내부 구조가 없는 경우 이 메서드의 구현은 단순히 S_OK 반환하고 ppenumMoniker 를 NULL로 설정할 수 있습니다.

구현별 참고 사항

구현	참고
안티 모니커	이 메서드는 S_OK 반환하고 ppenumMoniker 를 NULL로 설정합니다.
클래스 모니커	이 메서드는 S_OK 반환하고 ppenumMoniker 를 NULL로 설정합니다.
파일 모니커	이 메서드는 S_OK 반환하고 ppenumMoniker 를 NULL로 설정합니다.
제네릭 복합 모니커	성공하면 이 메서드는 S_OK 반환하고 복합을 구성하는 구성 요소 모니커를 열거하는 열거자를 다시 전달합니다. 그렇지 않으면 메서드는 E_OUTOFMEMORY 반환합니다.
항목 모니커	이 메서드는 S_OK 반환하고 ppenumMoniker 를 NULL로 설정합니다.
OBJREF 모니커	이 메서드는 S_OK 반환하고 ppenumMoniker 를 NULL로 설정합니다.
포인터 모니커	이 메서드는 E_NOTIMPL 반환합니다.
URL 모니커	이 메서드는 S_OK 반환하고 ppenumMoniker 를 NULL로 설정합니다.

요구 사항

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

추가 정보

IEnumMoniker

Imoniker