IPropertyStorage 인터페이스(propidl.h)

아티클
08/25/2023

IPropertyStorage 인터페이스는 단일 속성 집합의 영구 속성을 관리합니다. 영구 속성은 파일과 연결된 요약 정보와 같이 속성 집합에 영구적으로 저장할 수 있는 정보로 구성됩니다. 이는 시스템 동작에 영향을 미치는 데 사용할 수 있는 Controls 및 Automation과 연결된 런타임 속성과 대조됩니다. IPropertySetStorage 인터페이스의 메서드를 사용하여 영구 속성 집합을 만들거나 엽니다. IPropertySetStorage 인터페이스의 instance 0개 이상의 IPropertyStorage 인스턴스를 관리할 수 있습니다.

속성 집합 내의 각 속성은 해당 집합에 고유한 4 바이트 ULONG 값인 ID(속성 식별자)로 식별됩니다. IPropertyStorage 인터페이스를 통해 속성에 문자열 이름을 할당할 수도 있습니다.

속성 ID는 Automation dispid 속성 이름 태그에 사용되는 디스패치 ID와 다릅니다. 한 가지 차이점은 IDispatch에는 이러한 제한이 없지만 IPropertyStorage에서 속성 ID 값 0과 1의 범용 사용이 금지된다는 것입니다. 또한 IPropertyStorage 및 IDispatch에서 사용할 수 있는 속성 값에 대한 데이터 형식 간에 상당한 중복이 있지만 속성 집합은 동일하지 않습니다. IPropertyStorage 메서드에 사용되는 영구 속성 데이터 형식은 PROPVARIANT 구조에 정의됩니다.

IPropertyStorage 인터페이스를 사용하여 단순 및 비심플 속성 집합에 모두 액세스할 수 있습니다. 비심플 속성 집합은 단순 속성 집합에 보관할 수 없는 여러 복합 속성 형식을 포함할 수 있습니다. 자세한 내용은 속성 집합에 대한 스토리지 및 Stream 개체를 참조하세요.

상속

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

메서드

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


IPropertyStorage::Commit IPropertyStorage::Commit 메서드는 속성 스토리지 개체의 변경 내용을 부모 스토리지 개체에 저장합니다.
IPropertyStorage::D eleteMultiple IPropertyStorage::D eleteMultiple 메서드는 이 속성 집합에 있는 만큼 표시된 속성을 삭제합니다.
IPropertyStorage::D eletePropertyNames DeletePropertyNames 메서드는 현재 속성 집합에서 지정된 문자열 이름을 삭제합니다. (IPropertyStorage.DeletePropertyNames)
IPropertyStorage::Enum IPropertyStorage::Enum 메서드는 현재 속성 집합에 대한 정보를 포함하는 STATPROPSTG 형식의 데이터를 열거하도록 설계된 열거자 개체를 만듭니다.
IPropertyStorage::ReadMultiple IPropertyStorage::ReadMultiple 메서드는 현재 속성 집합에서 지정된 속성을 읽습니다.
IPropertyStorage::ReadPropertyNames IPropertyStorage::ReadPropertyNames 메서드는 지정된 속성 ID에 대한 기존 문자열 이름을 검색합니다.
IPropertyStorage::Revert IPropertyStorage::Revert 메서드는 마지막으로 연 이후 명명된 속성 집합에 대한 모든 변경 내용을 삭제하거나 속성 집합에 마지막으로 커밋된 변경 내용을 삭제합니다.
IPropertyStorage::SetClass IPropertyStorage::SetClass 메서드는 현재 속성 스토리지 개체에 새 CLSID를 할당하고 CLSID를 개체와 함께 영구적으로 저장합니다.
IPropertyStorage::SetTimes 구현에서 지원하는 경우 IPropertyStorage::SetTimes 메서드는 이 속성 집합의 수정, 액세스 및 생성 시간을 설정합니다.
IPropertyStorage::Stat IPropertyStorage::Stat 메서드는 현재 열려 있는 속성 집합에 대한 정보를 검색합니다. (IPropertyStorage.Stat)
IPropertyStorage::WriteMultiple IPropertyStorage::WriteMultiple 메서드는 지정된 속성 그룹을 현재 속성 집합에 씁니다.
IPropertyStorage::WritePropertyNames IPropertyStorage::WritePropertyNames 메서드는 현재 속성 집합의 지정된 속성 ID 배열에 문자열 IPropertyStoragenames를 할당합니다.

요구 사항

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