SHPropStgCreate 函式 (shlobj_core.h)

[此函式可透過 Windows XP Service Pack 2 (SP2) 和 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

要開啟的屬性集標識碼。 此參數的值可以是預先定義 屬性集格式識別碼 或任何其他 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*

當這個方法傳回時，會包含集合的代碼頁標識符位址。

傳回值

類型： HRESULT

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	shlobj_core.h
程式庫	Shell32.lib
Dll	Shell32.dll (6.0 版或更新版本)