StgCreatePropStg 함수(coml2api.h)

아티클
08/22/2023

StgCreatePropStg 함수는 지정된 스토리지 또는 스트림 개체에서 속성 집합을 만들고 엽니다. 속성 집합은 IPropertyStorage 인터페이스의 시스템 제공 독립 실행형 구현을 제공합니다.

구문

HRESULT StgCreatePropStg(
  [in]  IUnknown         *pUnk,
  [in]  REFFMTID         fmtid,
  [in]  const CLSID      *pclsid,
  [in]  DWORD            grfFlags,
  [in]  DWORD            dwReserved,
  [out] IPropertyStorage **ppPropStg
);

매개 변수

[in] pUnk

새 속성 집합을 저장하는 스토리지 또는 스트림 개체의 IUnknown 인터페이스에 대한 포인터입니다.

[in] fmtid

만들려는 속성 집합의 FMTID입니다.

[in] pclsid

이 속성 집합의 초기 CLSID에 대한 포인터입니다. NULL일 수 있습니다. 이 경우 pclsid는 모든 0으로 설정됩니다.

[in] grfFlags

속성 집합을 만들고 여는 방법을 결정하는 PROPSETFLAG 상수 의 값입니다.

[in] dwReserved

예약; 는 0이어야 합니다.

[out] ppPropStg

새 속성 집합에 대한 인터페이스 포인터를 수신하는 IPropertyStorage* 포인터 변수의 주소입니다.

반환 값

이 함수는 다음 외에도 E_INVALIDARG 및 E_UNEXPECTED 표준 반환 값을 지원합니다.

설명

StgCreatePropStg 는 IPropertyStorage 인터페이스의 시스템 제공 독립 실행형 구현을 제공하는 새 속성 집합을 만들고 엽니다. 새 속성 집합은 pUnk에 지정된 스토리지 또는 스트림 개체에 포함됩니다. grfFlags 매개 변수의 값은 pUnk가 스토리지 또는 스트림 개체를 지정하는지 여부를 나타냅니다. 예를 들어 PROPSETFLAG_NONSIMPLE 설정된 경우 스토리지 개체의 IStorage 인터페이스에 대해 pUnk를 쿼리할 수 있습니다.

두 경우 모두 이 함수는 속성 집합을 포함하는 스토리지 또는 스트림 개체에 대해 pUnk-AddRef>를 호출합니다. 더 이상 필요하지 않은 경우 개체를 해제하는 것은 호출자의 책임입니다.

이 함수는 IPropertySetStorage::Create 메서드와 비슷합니다. 그러나 StgCreatePropStg 는 pUnk 매개 변수를 추가하고 grfFlags 매개 변수에 대한 PROPSETFLAG_UNBUFFERED 값을 지원합니다. IPropertySetStorage 인터페이스를 지원하지 않는 IStorage 인터페이스가 있거나 PROPSETFLAG_UNBUFFERED 값을 사용하려는 경우 Create 메서드 대신 이 함수를 사용합니다. 이 PROPSETFLAG_UNBUFFERED 열거형 값을 사용하는 방법에 대한 자세한 내용은 PROPSETFLAG 상수를 참조하세요.

속성 집합에는 코드 페이지와 로캘 식별자(ID) 속성이 자동으로 포함됩니다. 각각 현재 시스템 기본값과 현재 사용자 기본값으로 설정됩니다.

grfFlags 매개 변수는 PROPSETFLAG 상수에서 가져온 값의 조합입니다. PROPSETFLAG_UNBUFFERED 새 열거형 값이 지원됩니다. 자세한 내용은 PROPSETFLAG 상수를 참조하세요.

이 함수는 SP2(서비스 팩 2)가 있는 Windows NT 4.0 이상에 포함되어 있으며 Windows 95, Windows 98 이상에서 재배포 가능 패키지로 사용할 수 있는 재배포 가능 Iprop.dll 내보냅니다. Windows 2000 및 Windows XP에서는 ole32.dll 내보내집니다. Windows 2000 및 Windows XP의 iprop.dll 내보낼 수도 있지만 호출은 ole32.dll 전달됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	coml2api.h(Propidl.h 포함)
라이브러리	Ole32.lib
DLL	Ole32.dll