IPropertySetStorage：：Create 方法 (propidl.h)

發行項
03/01/2024

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：：Open 的 grfMode 參數中，加上下表所列的值。

值	意義
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