IStorage 인터페이스(objidl.h)

IStorage 인터페이스는 구조적 스토리지 개체의 생성 및 관리를 지원합니다. 구조적 스토리지는 단일 파일 내에서 정보의 계층적 스토리지를 허용하며 종종 "파일 내의 파일 시스템"이라고 합니다. 구조적 스토리지 개체의 요소는 스토리지 및 스트림입니다. 스토리지는 디렉터리와 유사하며 스트림은 파일과 유사합니다. 구조화된 스토리지 내에는 하위 저장소, 중첩 및 스트림을 포함할 수 있는 기본 스토리지 개체가 있습니다. 스토리지는 개체의 구조를 제공하며 스트림에는 IStream 인터페이스를 통해 조작되는 데이터가 포함됩니다.

IStorage 인터페이스는 루트 스토리지 개체, 자식 스토리지 개체 및 스트림 개체를 만들고 관리하는 메서드를 제공합니다. 이러한 메서드는 스토리지 개체의 요소를 생성, 열기, 열거, 이동, 복사, 이름 바꾸기 또는 삭제할 수 있습니다.

애플리케이션은 사용된 메모리의 할당을 취소하기 위해 스토리지 개체로 수행될 때 해당 IStorage 포인터를 해제해야 합니다. 요소의 날짜와 시간을 변경하는 메서드도 있습니다.

STGM 상수에서 값을 설정하여 스토리지 개체와 해당 요소를 열 수 있는 다양한 모드가 있습니다. 이 것의 한 가지 측면은 변경 내용을 커밋하는 방법입니다. 개체에 대한 변경 내용이 즉시 기록되는 직접 모드 또는 명시적으로 커밋될 때까지 변경 내용이 버퍼에 기록되는 트랜잭션 모드를 설정할 수 있습니다. IStorage 인터페이스는 변경 내용을 커밋하고 마지막으로 커밋된 버전으로 되돌리는 메서드를 제공합니다. 예를 들어 스트림을 읽기 전용 모드 또는 읽기/쓰기 모드로 열 수 있습니다. 자세한 내용은 STGM 상수를 참조하세요.

다른 메서드는 STATSTG 구조를 통해 스토리지 개체 및 해당 요소에 대한 정보에 대한 액세스를 제공합니다.

상속

IStorage 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IStorage 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IStorage 인터페이스에는 이러한 메서드가 있습니다.

IStorage::Commit Commit 메서드는 트랜잭션 모드에서 열린 스토리지 개체에 대한 모든 변경 내용이 부모 스토리지에 반영되도록 합니다.
IStorage::CopyTo 열려 있는 스토리지 개체의 전체 내용을 다른 스토리지 개체에 복사합니다.
IStorage::CreateStorage 지정된 액세스 모드에서 지정된 이름을 사용하여 이 스토리지 개체 내에 중첩된 새 스토리지 개체를 만들고 엽니다.
IStorage::CreateStream 이 스토리지 개체에 포함된 지정된 이름을 사용하여 스트림 개체를 만들고 엽니다.
IStorage::D estroyElement 이 스토리지 개체에서 지정된 스토리지 또는 스트림을 제거합니다.
IStorage::EnumElements EnumElements 메서드는 이 스토리지 개체에 포함된 스토리지 및 스트림 개체를 열거하는 데 사용할 수 있는 열거자 개체에 대한 포인터를 검색합니다.
IStorage::MoveElementTo MoveElementTo 메서드는 하위 저장소 또는 스트림을 이 스토리지 개체에서 다른 스토리지 개체로 복사하거나 이동합니다.
IStorage::OpenStorage 지정된 액세스 모드에서 지정된 이름의 기존 스토리지 개체를 엽니다.
IStorage::OpenStream 지정된 액세스 모드에서 이 스토리지 개체 내의 기존 스트림 개체를 엽니다.
IStorage::RenameElement RenameElement 메서드는 이 스토리지 개체에서 지정된 하위 저장소 또는 스트림의 이름을 바꿉니다.
IStorage::Revert Revert 메서드는 마지막 커밋 작업 이후 스토리지 개체에 적용된 모든 변경 내용을 삭제합니다.
IStorage::SetClass SetClass 메서드는 지정된 CLSID(클래스 식별자)를 이 스토리지 개체에 할당합니다.
IStorage::SetElementTimes SetElementTimes 메서드는 기본 파일 시스템에서 이 메서드를 지원하는 경우 지정된 스토리지 요소의 수정, 액세스 및 생성 시간을 설정합니다.
IStorage::SetStateBits SetStateBits 메서드는 이 스토리지 개체에 최대 32비트 상태 정보를 저장합니다.
IStorage::Stat Stat 메서드는 이 열린 스토리지 개체에 대한 STATSTG 구조를 검색합니다.

요구 사항

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

추가 정보

EnumAll 샘플

샘플