guid = "GUID"
symbol = "String"
uri = "String"
name = "String"
description = "String"
instances = "String"
Short description of the counter set.
GUID that uniquely identifies the counter set. The counter set registration fails if the GUID is already registered. To update a counter set that is registered, you must first uninstall the counter set and then register it again.
Determines if the counter set can contain multiple instances.
Possible values include:
Defines a counter set where only one instance of the counters in the counter set can exist. Specify this value if the counters provide system-wide measurements, such as physical memory. This is the default.
Defines a counter set where multiple instances of the counters in the counter set can exist. Specify this value if the counters provide per instance measurements, such as processor time per process.
Defines a single instance counter set where the counters in the counter set must be aggregated from various active sources. For example, you could create a counter set that contains a counter that counts the number of disk reads for a hard disk. If the computer has three hard disks and a consumer queries for the number of disk reads, PERFLIB will obtain the number of reads from each disk and sum their individual values.
Defines a multiple instance counter set where the counters in the counter set must be aggregated across all instances of that counter. For example, you could create a counter set for a multi-threaded application that contains a counter that measures thread performance (each thread would refer to an instance of the counter set). When a consumer queries the total thread execution time counter, PERFLIB will sum the total thread execution time from each instance.
Defines a single instance counter set whose counter values are cached for the lifetime of the consumer. Note that all counters in the counter set are cached. To cache only specific counters, decorate those counters with the history attribute.
Using the disk read example from globalAggregate, all counter values in the counter set would be cached. If one disk became unavailable, the last cached value for total bytes read by that disk would still be available to the consumer application.
Display name of the counter set. Must be less than 1,024 characters. The name is case-sensitive.
A symbolic name that identifies the counter set. The CTRPP tool creates a GUID variable that you can use when calling functions that require the counter set GUID (for example, PerfCreateInstance). The variable name is of the form, symbolicnameGuid.
If you include the -prefix argument when calling CTRPP, the prefix string is added to the beginning of the symbolic name.
Windows 7: Not supported
Unique uniform resource identifier that lets users access the counters in the counter set from any location.