(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 |