IPropertySetStorage 시스템에서 제공하는 독립 실행형 구현에는 IPropertyStorage 및 IPropertySetStorage구현이 포함됩니다.IPropertyStorage 속성 집합 스토리지에서 속성을 읽고 쓰는 인터페이스입니다. IPropertySetStorage 스토리지에서 속성 집합을 만들고 여는 인터페이스입니다. IEnumSTATPROPSTG 및 IEnumSTATPROPSETSTG 인터페이스도 독립 실행형 구현에서 제공됩니다.
IPropertySetStorage독립 실행형 구현을 사용하려면 먼저 시스템에서 제공하는 독립 실행형 구현에 대한 포인터를 가져오고 시스템 제공 구현을 스토리지 개체와 연결합니다. IPropertySetStorage독립 실행형 구현에 대한 포인터를 얻으려면 StgCreatePropSetStg 함수를 호출하고 속성 집합을 포함할 스토리지 개체를 지정하는 pStorage 매개 변수를 제공합니다. 이 함수는 지정된 스토리지 개체에 대한 새 IPropertySetStorage 인터페이스에 대한 포인터를 제공합니다.
IPropertySetStorage 독립 실행형 구현은 복합 파일 스토리지뿐만 아니라 모든 스토리지 개체에 속성 집합을 만듭니다. 독립 실행형 구현은 복합 파일에 의존하지 않으며 구조화된 스토리지의 구현과 함께 사용할 수 있습니다. 호출자가 제공하는 구조적 스토리지에 대한 제한 사항은 이 속성 집합 구현에 적용됩니다. 예를 들어 StgOpenPropStg간단한 모드 스토리지를 제공하는 경우 제공된 IStorage따라 결과 IPropertySetStorage 제한됩니다.
이 인터페이스의 복합 파일 구현에 대한 자세한 내용은 파일 구현 IPropertySetStorage-Compound 섹션을 참조하세요.
사용 시기
IPropertySetStorage 메서드를 호출하여 구조화된 스토리지에서 속성 집합을 만들고, 열고, 삭제합니다. 스토리지의 속성 집합을 열거하는 데 사용할 수 있는 IEnumSTATPROPSETSTG 열거자에 대한 포인터를 제공하는 메서드도 있습니다.
또한 독립 실행형 구현은 StgCreatePropStg 및 StgOpenPropStg 도우미 함수와 만들기 및 Open 메서드를 제공하여 속성 집합을 만들고 엽니다. 이러한 두 함수는 PROPSETFLAG_UNBUFFERED 값에 대한 지원을 추가하므로 캐시에서 버퍼링하는 대신 속성 집합에 직접 변경 내용을 쓸 수 있습니다. 자세한 내용은 PROPSETFLAG 상수참조하세요.
방법
IPropertySetStorage 독립 실행형 구현은 다음 메서드를 지원합니다.
-
스토리지에 새 속성 집합을 만들고 속성 집합의 IPropertyStorage 인터페이스에 대한 포인터를 반환합니다.
PROPSETFLAG_UNBUFFERED 값을 사용하려는 경우 StgCreatePropStg 함수를 대신 사용하여 새 속성 집합을 만들고 열고 속성 집합의 IPropertyStorage 인터페이스에 대한 독립 실행형 구현에 대한 포인터를 가져옵니다.
-
스토리지에서 기존 속성 집합을 열고 속성 집합의 IPropertyStorage 인터페이스에 대한 포인터를 반환합니다.
PROPSETFLAG_UNBUFFERED 값을 사용하려는 경우 StgOpenPropStg 함수를 대신 사용하여 지정된 속성 집합에서 IPropertyStorage 독립 실행형 구현에 대한 포인터를 가져옵니다.
-
이 속성 집합 스토리지의 속성 집합을 삭제합니다.
-
STATPROPSETSTG 구조를 열거하는 데 사용할 수 있는 개체를 만듭니다. 각 STATPROPSETSTG 구조체는 단일 속성 집합에 대한 데이터를 제공합니다.
메모
DocumentSummaryInformation 및 사용자 정의 속성 집합은 단일 기본 스트림에 두 개의 속성 집합 섹션이 있을 수 있다는 측면에서 고유합니다. 자세한 내용은 DocumentSummaryInformation 및 사용자 정의 속성 집합 참조하세요.
관련 항목