This method removes all items currently in the EventPipe and returns them as a SAFEARRAY of IDispatch pointers to PIEventObjects.
The object placeholder is an object expression that evaluates to an EventPipe object.
The PIEventObject returned will have contents that depend on the event pipe from which it was retrieved. See the PIEventObject for details.
In versions prior to 1.4, when a user explicitly closes a server used by an EventPipe, the PI-SDK marks the EventPipe as a disconnected object. For an EventPipe connected to multiple servers, closing any one of the servers will mark the entire EventPipe as a disconnected object. Further method calls on the EventPipe will return a pseDISCONNECTEDOBJECT error, except in the case of ListSignup for an EventPipe of type of eptPointList or eptPointListArchive. Version 1.4 of the PI-SDK removes this restriction. See the help page on Disconnected Objects for more details.