3.1.4.4.32 GetSubscriberPropertyCollection (Opnum 38)

The GetSubscriberPropertyCollection method gets the collection of all the application-specific subscriber properties for the subscription, as specified in section 3.1.1.2.

 [id(20), helpstring("method GetSubscriberPropertyCollection")] HRESULT GetSubscriberPropertyCollection(
   [out, retval] IEventObjectCollection** collection
 );

collection: If the function returns a success HRESULT, this MUST return an instance of a DCOM object supporting the IEventObjectCollection which MUST contain a collection of application-specific subscriber properties. These properties MUST conform to the specification given in section 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 enumerate all subscriber properties associated with the instance of the DCOM object servicing this call. It MUST attempt to store these in a collection DCOM object supporting IEventObjectCollection interface, and fail the call, returning a failure HRESULT back to the client if it cannot. It MUST then return this DCOM object instance through the collection parameter and fail the call if it cannot.