共用方式為


(comsvcs.h) ISharedPropertyGroup::CreatePropertyByPosition 方法

使用指定的索引建立新的共享屬性。 如果具有指定索引的共用屬性已經存在, CreatePropertyByPosition 會傳回現有索引的參考。

語法

HRESULT CreatePropertyByPosition(
  [in]  int             Index,
  [out] VARIANT_BOOL    *fExists,
  [out] ISharedProperty **ppProp
);

參數

[in] Index

SharedPropertyGroup 對象中參考新屬性的數值索引。 您稍後可以使用此索引,透過 get_PropertyByPosition 方法來擷取共用屬性。

[out] fExists

布爾值的參考。 如果 fExists 在從這個方法傳回時設定為 VARIANT_TRUE, 則 Index 所指定的共用屬性會在此呼叫之前存在。 如果設定為 VARIANT_FALSE,則此屬性是由這個呼叫所建立。

[out] ppProp

由傳入 Index 參數之數值索引所識別之共用屬性對象的參考,如果遇到錯誤,則為 NULL

傳回值

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

備註

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

如果您使用 CreatePropertyByPosition 方法建立 SharedProperty 物件,您只能使用 get_PropertyByPosition 方法來存取該屬性。 您無法將字串名稱指派給相同的屬性,然後使用 get_Property 方法來存取它。 依位置存取屬性的速度比使用字串名稱來存取屬性更快,因為它需要較少的額外負荷。

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

規格需求

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

另請參閱

ISharedProperty

ISharedPropertyGroup