StgOpenPropStg 함수(coml2api.h)

아티클
08/22/2023

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

구문

HRESULT StgOpenPropStg(
  [in]  IUnknown         *pUnk,
  [in]  REFFMTID         fmtid,
  [in]  DWORD            grfFlags,
  [in]  DWORD            dwReserved,
  [out] IPropertyStorage **ppPropStg
);

매개 변수

[in] pUnk

요청된 속성 집합 개체를 포함하는 스토리지 또는 스트림 개체의 IUnknown 인터페이스에 대한 인터페이스 포인터입니다.

[in] fmtid

열 속성 집합의 FMTID입니다.

[in] grfFlags

PROPSETFLAG 상수의 값입니다.

[in] dwReserved

나중에 사용하도록 예약되어 있습니다. 0이어야 합니다.

[out] ppPropStg

요청된 속성 집합에 대한 인터페이스 포인터를 수신하는 IPropertyStorage* 포인터 변수에 대한 포인터입니다.

반환 값

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

설명

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

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

이 함수는 IPropertySetStorage::Open 메서드와 유사합니다. 그러나 StgOpenPropStg는 grfFlags 매개 변수의 PROPSETFLAG_UNBUFFERED 값을 포함하여 pUnk 및 grfFlags 매개 변수를 추가합니다. IPropertySetStorage 인터페이스를 지원하지 않는 IStorage 인터페이스가 있거나 PROPSETFLAG_UNBUFFERED 값을 사용하려는 경우 Open 메서드 대신 이 함수를 사용합니다. PROPSETFLAG_UNBUFFERED 사용에 대한 자세한 내용은 PROPSETFLAG 상수를 참조하세요.

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

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

요구 사항

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