Share via

3.1.4.8.2 put_FilterCriteria (Opnum 42)

  • Article

The put_FilterCriteria method sets the value of the FilterCriteria property of the subscription.

 [propput, id(22), helpstring("property FilterCriteria")] HRESULT FilterCriteria(
   [in] BSTR bstrFilterCriteria
 );

bstrFilterCriteria: The FilterCriteria property of the subscription, as specified in section 3.1.1.2. The syntax for this string is specified in section 2.2.1.

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 the new value of the property for syntax. If validation fails, the server MUST fail the call, returning a failure HRESULT back to the client. Otherwise, the server MUST attempt to update the state of the DCOM object servicing this method with the new value of the FilterCriteria property, and fail the call if it cannot. Otherwise, it MUST override any previous value that was set for this DCOM object instance servicing this method call.