Share via

4 Protocol Examples

  • Article

To manually create a data collector set with a performance counter data collector:

Manually creating a data collector set with a performance counter data collector

Figure 2: Manually creating a data collector set with a performance counter data collector

  1. The client creates a data collector set object on the server by using CoCreateInstanceEx.

  2. The server returns a pointer to the newly created object.

  3. The client requests the data collector set's collection of data collector.

  4. The server returns a pointer to the collection of data collectors belonging to the data collector set.

  5. The client requests the creation of a Performance Counter Data Collectors.

  6. The server creates a new Performance Counter Data Collector and retuns a pointer to its IDataCollector interface.

  7. The client requests the IPerformanceCounterDataCollector interface of the returned data collector.

  8. The server returns a pointer to the IPerformanceCounterDataCollector interface of the data collector.

  9. The client requests that the server updates the list of performance counters to be collected.

  10. The server stores that list in the Data Collector object and returns the status of the operation.

  11. The client requests that the server adds the performance counter data collector to the data collector set collection.

  12. The server adds the data collector to the collection and replies indicating whether the operation was successful.

  13. The client requests that the server commits the data collector set to storage.

  14. The server commits the data collector set and replies indicating whether the operation was successful.

  15. The client releases a pointer to the data collector set object.

  16. The client releases a pointer to the Data Collector Collection object.

  17. The client releases a pointer to the data collector.

  18. The client releases a pointer to the IPerformanceCounterDataCollector interface of the data collector.

To start a data collector set:

Starting a data collector set

Figure 3: Starting a data collector set

  1. The client creates a data collector set object on the server using CoCreateInstanceEx

  2. The server returns a pointer to the newly created object.

  3. The client requests that the settings of a previously committed data collector set be loaded into the returned data collector set object.

  4. The server loads the requested data collector set from storage into memory and replies indicating whether the operation was successful.

  5. The client requests that the data collector set start.

  6. The server starts collecting the data described by the data collector set, and replies indicating whether the operation was successful.

  7. The client releases pointer to the data collector set object.

To create a data collector set from an XML file:

Creating a data collector set from an XML file

Figure 4: Creating a data collector set from an XML file

  1. The client creates a data collector set object on the server using CoCreateInstanceEx.

  2. The server returns a pointer to the newly created object.

  3. The client requests that the settings specified in the XML be loaded into the returned data collector set object.

  4. The server parses the XML, extracts the valid properties, applies valid properties to the data collector set server, and replies indicating whether the operation was successful.

  5. The client requests that the server commit the data collector set to storage.

  6. The server commits the data collector set and replies indicating whether operation was successful.

  7. The client releases a pointer to the data collector set object.