ISharedPropertyGroup：：CreateProperty 方法 (comsvcs.h)

使用指定的名稱建立新的共享屬性。如果該名稱的共用屬性已經存在， CreateProperty 會傳回現有屬性的參考。

語法

HRESULT CreateProperty(
  [in]  BSTR            Name,
  [out] VARIANT_BOOL    *fExists,
  [out] ISharedProperty **ppProp
);

[in] Name

要建立的屬性名稱。您稍後可以使用這個名稱，使用 get_Property 方法來取得此屬性的參考。

[out] fExists

布爾值的參考，如果 Name 參數中指定的 共用屬性存在這個呼叫之前，則會在傳回時設定為VARIANT_TRUE，如果屬性是由這個呼叫所建立，則VARIANT_FALSE。

[out] ppProp

具有 Name 參數中所指定名稱的 SharedProperty 對象的參考，如果遇到錯誤，則為 NULL。

這個方法可以傳回標準傳回值E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL和S_OK。

當您建立共用屬性時，其值會設定為預設值，這是值為0的 VT_I4 VARIANT。

如果您使用 CreateProperty 方法建立共用屬性，您只能使用 get_Property 方法來存取該屬性。您無法將數值索引指派給相同的屬性，然後使用 get_PropertyByPosition 方法加以存取。

相同的共用屬性群組可以包含一些以名稱識別的 SharedProperty 物件，以及依位置識別的其他物件。