共用方式為


IPropertySetStorage::Create 方法 (propidl.h)

Create 方法會在屬性集儲存物件中建立並開啟新的屬性集。

語法

HRESULT Create(
  [in]  REFFMTID         rfmtid,
  [in]  const CLSID      *pclsid,
  [in]  DWORD            grfFlags,
  [in]  DWORD            grfMode,
  [out] IPropertyStorage **ppprstg
);

參數

[in] rfmtid

要建立之屬性集的 FMTID。 如需平臺 SDK 中已知和預先定義的 FMTID 相關信息,請參閱 預先定義的屬性集格式識別碼

[in] pclsid

這個屬性集之初始類別標識碼 CLSID 的指標。 可以是 NULL,在此情況下,它會設定為所有零。 CLSID 是類別的 CLSID,可顯示和/或提供屬性值的程式設計存取。 如果沒有這類類別,建議使用 FMTID。

[in] grfFlags

PROPSETFLAG 常數的值

[in] grfMode

要開啟新建立屬性集的存取模式,取自 STGM_Constants的特定值,如下一節所述。

[out] ppprstg

接收 IPropertyStorage 介面指標之輸出變數的指標。

傳回值

這個方法支持標準傳回值E_UNEXPECTED,以及下列專案:

備註

IPropertySetStorage::Create 會建立並開啟新的屬性集子物件, (支援此屬性集儲存物件中包含的 IPropertyStorage 介面) 。 屬性集會自動包含代碼頁和地區設定標識元屬性。 這些分別設定為 Unicode 和目前的用戶預設值。

grfFlags 參數是取自 PROPSETFLAG 常數的值組合。 如果使用這個列舉中的PROPSETFLAG_ANSI值,代碼頁會設定為目前的系統預設值,而不是 Unicode。

grfMode 參數會指定要開啟新建立集的存取模式。 此參數的值如同在 IPropertySetStorage::OpengrfMode 參數中,加上下表所列的值。

意義
STGM_FAILIFTHERE 如果具有指定 fmtid 參數的另一個屬性存在,則呼叫會失敗。 這是默認動作;也就是說,除非指定STGM_CREATE,否則會隱含STGM_FAILIFTHERE。
STGM_CREATE 如果已存在以指定 fmtid 參數設定的另一個屬性,則會移除該屬性,並將其取代為這個新屬性。
 

根據預設,所建立的屬性集很簡單,但呼叫端可以藉由在 grfFlags 參數中指定PROPSETFLAG_NONSIMPLE值來要求非簡單屬性集。 如需簡單和非簡單屬性集的詳細資訊,請參閱屬性集的記憶體和 Stream物件

此方法受限於簡單屬性集的基礎 IStorage::CreateStream (條件約束,) 或 IStorage::CreateStorage (非簡單屬性集) 。 例如,使用 IPropertySetStorage-Compound File 實作時,請將 grfMode 參數中的STGM_SHARE_EXCLUSIVE指定為 IPropertySetStorage::Create。 相反地,如果使用 IPropertySetStorage-獨立實作, IPropertySetStorage::Create 受限於套用至呼叫端指定 IStorage 的條件約束。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 propidl.h (包含 Objbase.h)
程式庫 Uuid.lib
Dll Ole32.dll

另請參閱

IPropertySetStorage

IPropertySetStorage::Open

PROPSETFLAG 常數

範例

StgCreatePropSetStg 範例

WriteRead 範例