3.1.4.4.30 PutSubscriberProperty (Opnum 36)
The PutSubscriberProperty method sets the value of an application-specific subscriber property of the subscription, as specified in section 3.1.1.2.
-
[id(18), helpstring("method PutSubscriberProperty")] HRESULT PutSubscriberProperty( [in] BSTR bstrPropertyName, [in] 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: 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 the bstrPropertyName and propertyValue parameter. If the validation fails, the server MUST fail the call, returning a failure HRESULT back to the client. Otherwise, the server MUST attempt to store the value into the state of the DCOM object instance servicing this call specific to the subscriber properties, and fail the call if it cannot. The server MUST override any previously associated value with this property name.