共用方式為


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 物件,以及依位置識別的其他物件。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 comsvcs.h

另請參閱

ISharedProperty

ISharedPropertyGroup