StgCreatePropStg 函式 (coml2api.h)

發行項
02/26/2024

StgCreatePropStg 函式會在指定的記憶體或數據流物件中建立並開啟屬性集。屬性集提供 IPropertyStorage 介面的系統提供的獨立實作。

語法

HRESULT StgCreatePropStg(
  [in]  IUnknown         *pUnk,
  [in]  REFFMTID         fmtid,
  [in]  const CLSID      *pclsid,
  [in]  DWORD            grfFlags,
  [in]  DWORD            dwReserved,
  [out] IPropertyStorage **ppPropStg
);

參數

[in] pUnk

儲存新屬性集之記憶體或數據流物件上 IUnknown 介面的指標。

[in] fmtid

要建立之屬性集的 FMTID。

[in] pclsid

此屬性集之初始 CLSID 的指標。可以是 NULL，在此情況下 ，pclsid 會設定為所有零。

[in] grfFlags

PROPSETFLAG 常數中的值，決定如何建立和開啟屬性集。

[in] dwReserved

保留;必須是零。

[out] ppPropStg

接收新屬性集介面指標的 IPropertyStorage* 指標變數位址。

傳回值

除了下列專案外，此函式還支援標準傳回值E_INVALIDARG和E_UNEXPECTED：

備註

StgCreatePropStg 會建立並開啟新的屬性集，以提供 IPropertyStorage 介面的系統提供的獨立實作。新的屬性集包含在 pUnk 所指定的記憶體或資料流物件中。 grfFlags 參數的值會指出 pUnk 是否指定記憶體或數據流物件。例如，如果已設定PROPSETFLAG_NONSIMPLE，則可以查詢記憶體物件上的 IStorage 介面 pUnk。

不論是哪一種情況，此函式都會針對包含屬性集的記憶體或數據流物件呼叫 pUnk-AddRef>。當不再需要物件時，呼叫端必須負責釋放物件。

此函式類似於 IPropertySetStorage：：Create 方法。不過， StgCreatePropStg 會新增 pUnk 參數，並支援 grfFlags 參數的PROPSETFLAG_UNBUFFERED值。如果您有不支援 IPropertySetStorage 介面的 IStorage 介面，或是想要使用 PROPSETFLAG_UNBUFFERED 值，請使用這個函式，而不是 Create 方法。如需使用此PROPSETFLAG_UNBUFFERED列舉值的詳細資訊，請參閱 PROPSETFLAG 常數。

屬性集會自動包含代碼頁和地區設定標識碼 (識別碼) 屬性。這些分別設定為目前的系統預設值和目前的用戶預設值。

grfFlags 參數是取自 PROPSETFLAG 常數的值組合。支援新的列舉值PROPSETFLAG_UNBUFFERED。如需詳細資訊，請參閱 PROPSETFLAG 常數。

此函式會從可轉散發 Iprop.dll 導出，隨附於 service Pack 2 (SP2) 和更新版本中的 Windows NT 4.0 中，並可在 Windows 95、Windows 98 和更新版本中以可轉散發套件的形式提供。在 Windows 2000 和 Windows XP 中，它會從 ole32.dll 導出。它也可以從 Windows 2000 和 Windows XP 中的 iprop.dll 導出，但呼叫會轉接至 ole32.dll。

規格需求

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