IShellFolder::EnumObjects 메서드(shobjidl_core.h)

항목 식별자 열거형 개체를 만들고 해당 IEnumIDList 인터페이스를 반환하여 클라이언트가 폴더의 내용을 확인할 수 있도록 합니다. 그런 다음 해당 인터페이스에서 지원하는 메서드를 사용하여 폴더의 내용을 열거할 수 있습니다.

구문

HRESULT EnumObjects(
  [in]  HWND        hwnd,
  [in]  SHCONTF     grfFlags,
  [out] IEnumIDList **ppenumIDList
);

매개 변수

[in] hwnd

형식: HWND

열거형을 수행하기 위해 사용자 입력이 필요한 경우 이 창 핸들은 열거형 개체에서 부모 창으로 사용하여 사용자 입력을 가져와야 합니다. 예를 들어 암호를 요청하거나 사용자에게 CD 또는 플로피 디스크를 삽입하라는 메시지를 표시하는 대화 상자가 있습니다. hwndOwner가 NULL로 설정된 경우 열거자는 메시지를 게시하지 않아야 하며 사용자 입력이 필요한 경우 자동으로 실패해야 합니다.

[in] grfFlags

형식: SHCONTF

열거형에 포함할 항목을 나타내는 플래그입니다. 가능한 값 목록은 SHCONTF 열거형 형식을 참조하세요.

[out] ppenumIDList

형식: IEnumIDList**

이 메서드에서 만든 열거형 개체의 IEnumIDList 인터페이스에 대한 포인터를 수신하는 주소입니다. 오류가 발생하거나 적절한 하위 개체를 찾을 수 없는 경우 ppenumIDList 가 NULL로 설정됩니다.

반환 값

형식: HRESULT

성공하면 S_OK를 반환하고, 그렇지 않으면 오류 값을 반환합니다. 일부 구현은 전달된 grfFlag와 일치하는 자식이 없음을 나타내는 를 반환S_FALSE할 수도 있습니다. 가 반환되면 S_FALSEppenumIDList 가 로 NULL설정됩니다.

설명

메서드가 S_OK 반환하는 경우 ppenumIDList 는 열거자에 대한 포인터를 받습니다. 이 경우 호출 애플리케이션은 Release 메서드를 호출하여 반환된 IEnumIDList 개체를 해제해야 합니다.

메서드가 S_FALSE 반환하는 경우 폴더에 적합한 하위 개체가 없고 ppenumIDList 에 지정된 포인터가 NULL로 설정됩니다.

메서드가 실패하면 오류 값이 반환되고 ppenumIDList 에 지정된 포인터가 NULL로 설정됩니다.

폴더에 적합한 하위 개체가 없는 경우 IShellFolder::EnumObjects 메서드는 *ppenumIDList 를 NULL 로 설정하고 S_FALSE 반환하거나 개체를 생성하지 않고 S_OK 반환하는 열거자로 *ppenumIDList 를 설정하도록 허용됩니다. 두 성공 사례 모두에 대해 호출 애플리케이션을 준비해야 합니다.

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)
DLL	Shell32.dll(버전 4.0 이상)

추가 정보

IShellFolder

IShellFolder2

SHGetDesktopFolder