SHPropStgCreate 함수(shlobj_core.h)

[이 함수는 Windows XP SP2(서비스 팩 2) 및 Windows Server 2003을 통해 사용할 수 있습니다. 이후 버전의 Windows에서는 변경되거나 사용하지 못할 수 있습니다.]

요청된 속성 집합 작업에 대한 코드 페이지 검색 또는 할당의 적절한 처리를 보장합니다.

구문

SHSTDAPI SHPropStgCreate(
  [in]            IPropertySetStorage *psstg,
  [in]            REFFMTID            fmtid,
  [in, optional]  const CLSID         *pclsid,
                  DWORD               grfFlags,
                  DWORD               grfMode,
                  DWORD               dwDisposition,
  [out]           IPropertyStorage    **ppstg,
  [out, optional] UINT                *puCodePage
);

매개 변수

[in] psstg

형식: IPropertySetStorage*

IPropertySetStorage 인터페이스에 대한 포인터입니다.

[in] fmtid

형식: REFFMTID

열 속성 집합 ID입니다. 이 매개 변수의 값은 미리 정의된 속성 집합 형식 식별자에 정의된 값 또는 등록하는 다른 FMTID 중 하나일 수 있습니다.

[in, optional] pclsid

형식: const CLSID*

집합과 연결된 CLSID에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다.

grfFlags

형식:DWORD

속성 집합을 만들고 여는 방법을 결정하는 PROPSETFLAG 열거형의 하나 이상의 멤버입니다. ANSI 바이트를 포함하는 모든 집합은 PROPSETFLAG_ANSI 사용하여 만들어야 합니다. 그렇지 않으면 PROPSETFLAG_DEFAULT.

grfMode

형식:DWORD

개체의 개체 및 액세스 모드를 만들고 삭제하기 위한 조건을 나타내는 STGM 열거형의 플래그입니다. STGM_DIRECT 포함되어야 합니다. | STGM_SHARE_EXCLUSIVE.

dwDisposition

형식:DWORD

Fileapi.h에 정의된 다음 값 중 하나입니다.

CREATE_NEW (1)

새 집합이 없는 경우 새 집합을 만듭니다.

CREATE_ALWAYS (2)

항상 새 집합을 만들고 기존 집합을 덮어씁니다.

OPEN_EXISTING (3)

기존 집합을 엽니다.

OPEN_ALWAYS (4)

[out] ppstg

형식: IPropertyStorage**

이 메서드가 반환되면 에는 IPropertyStorage 인터페이스 포인터가 포함됩니다.

[out, optional] puCodePage

형식: UINT*

이 메서드가 반환되면 집합에 대한 코드 페이지 ID의 주소가 포함됩니다.

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 성공하지 않으면 HRESULT 오류 코드를 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shlobj_core.h
라이브러리	Shell32.lib
DLL	Shell32.dll(버전 6.0 이상)