Platform SDK: Transaction Server

ISharedPropertyGroup::get_Property 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 a string name.

Provided By

ISharedPropertyGroup Interface

HRESULT ISharedPropertyGroup::get_Property (
    BSTR name,
    ISharedProperty** ppProperty,
);

Parameters

name
[in] The name of the shared property to retrieve.

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

Return Values

S_OK
The shared property specified by name 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 name specified in the name parameter.

Remarks

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

Example

See Also

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