Platform SDK: Transaction Server

ISharedPropertyGroup::get_PropertyByPosition Method

[This product will work only on Windows NT 4.0 versions and earlier. For Windows 2000 and later, see COM+ (Component Services).]

Returns a reference to an existing shared property identified by its numeric index within the property group.

Provided By

ISharedPropertyGroup Interface

HRESULT ISharedPropertyGroup::get_PropertyByPosition (
    INT index,
    ISharedProperty** ppProperty,
);

Parameters

index
[in] The numeric index within the SharedPropertyGroup of the property to retrieve.

ppProperty
[out] A reference to the shared property specified by the index parameter, or NULL if the property doesn't exist.

Return Values

S_OK
The shared property specified by index was found and a reference to it is returned in the ppProperty parameter.

E_INVALIDARG
Either the argument passed in the ppProperty parameter was a null pointer, or there is no property in the shared property group with the index number specified in the index parameter.

Remarks

You can use only the get_PropertyByPosition method to access properties that were created with the CreatePropertyByPosition method. To access properties that were created with the CreateProperty method, use the get_Property method.

Example

See Also

Sharing State, ISharedPropertyGroup::CreateProperty Method, ISharedPropertyGroup::CreatePropertyByPosition Method, ISharedPropertyGroup::get_Property Method