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