3.1.4.4.29 GetSubscriberProperty (Opnum 35)
The GetSubscriberProperty method gets the value of an application-specific subscriber property of the subscription, as specified in section 3.1.1.2.
-
[id(17), helpstring("method GetSubscriberProperty")] HRESULT GetSubscriberProperty( [in] BSTR bstrPropertyName, [out, retval] VARIANT* propertyValue );
bstrPropertyName: The application-specific name for the subscriber property. The format for the subscriber property name MUST adhere to the format specified in section 2.2.2.1.
propertyValue: If the function returns a success HRESULT, this MUST contain the application-specific subscriber property value which MUST be of the type specified in 2.2.2.2.
Return Values: An HRESULT specifying success or failure. All success codes MUST be treated the same, and all failure codes MUST be treated the same.
When this method is invoked, the server MUST validate both instances of bstrPropertyName. If validation fails, the server MUST fail the call, returning a failure HRESULT back to the client. The server MUST then check to see if the value for this property is associated with the state of the instance of the DCOM object servicing this call specific to subscriber properties. The server MUST verify that the value was previously set on this DCOM object instance servicing this method call. If not, the server MUST fail the call. Otherwise, the server MUST return the value of the property.