IStorage::EnumElements 메서드(objidl.h)
EnumElements 메서드는 이 스토리지 개체에 포함된 스토리지 및 스트림 개체를 열거하는 데 사용할 수 있는 열거자 개체에 대한 포인터를 검색합니다.
구문
HRESULT EnumElements(
[in] DWORD reserved1,
[in] void *reserved2,
[in] DWORD reserved3,
[out] IEnumSTATSTG **ppenum
);
매개 변수
[in] reserved1
나중에 사용하도록 예약되어 있습니다. 0이어야 합니다.
[in] reserved2
향후 사용을 위해 예약됨; 은 NULL이어야 합니다.
[in] reserved3
나중에 사용하도록 예약되어 있습니다. 0이어야 합니다.
[out] ppenum
새 열거자 개체에 대한 인터페이스 포인터를 수신하는 IEnumSTATSTG* 포인터 변수에 대한 포인터입니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
| S_OK | 열거자 개체가 성공적으로 반환되었습니다. |
| E_PENDING | 비동기 스토리지만 해당: 요소의 데이터 일부 또는 전체를 현재 사용할 수 없습니다. |
| STG_E_INSUFFICIENTMEMORY | 메모리 부족으로 인해 열거자 개체를 만들 수 없습니다. |
| STG_E_INVALIDPARAMETER | 매개 변수 중 하나가 잘못되었습니다. |
| STG_E_REVERTED | 스토리지 개체는 트랜잭션 트리에서 위의 되돌리기 작업에 의해 무효화되었습니다. |
설명
이 메서드에서 반환된 열거자 개체는 Next, Reset, Clone 및 Skip 메서드를 포함하는 표준 열거자 인터페이스 중 하나인 IEnumSTATSTG 인터페이스를 구현합니다. IEnumSTATSTG 는 STATSTG 구조의 배열에 저장된 데이터를 열거합니다.
스토리지 개체는 해당 요소의 열거를 허용하려면 읽기 모드로 열려 있어야 합니다.
열거자 개체는 임의의 순서로 요소를 열거할 수 있습니다. 열거자 개체는 열거형을 스냅샷 처리하거나 열거형이 스토리지 개체의 현재 상태를 반영하도록 허용됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | objidl.h |
| 라이브러리 | Uuid.lib |
| DLL | Ole32.dll |