IPersistSerializedPropStorage::GetPropertyStorage 메서드(propsys.h)

속성 저장소 instance 직렬화된 속성 스토리지 데이터를 가져옵니다.

구문

HRESULT GetPropertyStorage(
  [out] SERIALIZEDPROPSTORAGE **ppsps,
  [out] DWORD                 *pcb
);

매개 변수

[out] ppsps

형식: SERIALIZEDPROPSTORAGE**

이 메서드가 반환될 때 에는 직렬화된 속성 스토리지 데이터에 대한 포인터의 주소가 포함됩니다.

[out] pcb

형식: DWORD*

이 메서드가 반환될 때 는 ppsps가 가리키는 직렬화된 속성 스토리지 데이터에 포함된 바이트 수를 포함합니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

SERIALIZEDPROPSTORAGE 형식은 Propsys.h에서 불완전한 형식으로 정의됩니다. BYTE 값의 배열로 처리해야 합니다. 반환된 데이터의 형식이 지정되지 않았습니다. SERIALIZEDPROPSTORAGE 구조체의 내용은 디스크 또는 다른 스토리지에 유지하는 데 적합하며 IPersistSerializedPropStorage::SetPropertyStorage를 통해 다른 속성 저장소를 초기화하는 데 사용할 수 있습니다.

참고IPersistSerializedPropStorage::GetPropertyStorage 를 호출하여 나중에 CoTaskMemFree 를 호출하여 더 이상 필요하지 않은 경우 ppsps 에서 참조하는 메모리를 해제하는 것은 애플리케이션의 책임입니다.

 

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	propsys.h