When the EXCTRLST utility is started, it scans the registry to determine which applications, devices, and services have registered extensible performance counter DLLs. These DLLs are listed in the list box of the display along with the corresponding application, driver, or service. The EXCTRLST utility does not test for the existence of the DLLs.
The following table contains descriptions for the different fields displayed in the EXCTRLST dialog box.
| Field | Description |
|---|---|
| Machine name | The name of the machine from which the information is read. The default value is the local machine. However, you can use the name of any machine for which you have permission to read the registry. |
| Refresh | When you click this button, the utility updates the display with current information from the registry of the selected machine. |
| Sort Order | The sort order for the items displayed in the Extensible Performance Counters list box. The default sort order is By Library Name, which sorts the list in alphabetical order by the name of the DLL. If By Service Name is selected, the list is sorted by the name of the service entry in the registry. |
| Extensible Performance Counters |
A list box that contains the names of the services that provide performance counters, and the DLL that provides this information. The order is determined by the Sort Order selection. |
| DLL Name | The entry found in the registry for the DLL that Windows NT is to load for the performance data provided by this service. Either the file must be located in the system path, or you must provide the fully qualified path to the DLL. If the DLL is not found, the system logs an error in the Application event log. |
| Open Procedure | The name of the DLL function that initializes the performance functions for the service. This function must be exported by the DLL and must return success. If this function is not found in the DLL or if it returns an error, the system logs an error in the Application event log. |
| Collect Procedure | The name of the DLL function that collects the performance data for the service. This function is called each time an application, such as Performance Monitor, requests performance data. If this function is not found in the DLL or causes an error, the system logs an error in the Application event log. |
| Close Procedure | The name of the DLL function that performs any termination or cleanup when the application requesting performance data closes its interface to the performance registry. If this function is not found in the DLL, the system logs an error in the Application event log. |
| Counter ID Range | When the extensible performance counter DLL is installed, the system assigns a range of Index values to its object and counter name strings. The values assigned during installation are displayed here. If the service uses pre-assigned index values, this entry is not applicable, and the value of this field is N/A. If there is a problem with the entry for the service, its counters are not displayed, and this field is Not Found. |
| Help ID Range | When the extensible performance counter DLL is installed, the system assigns a range of index values to its object and counter descriptions. The indices used are the corresponding counter or object name string index + 1. The values assigned during installation are displayed here. If the service uses pre-assigned index values, this entry is not applicable, and the value of this field is N/A. If there is a problem with the entry for the service, its counters are not displayed, and this field is Not Found. |
Note The values for the Counter ID Range and Help ID Range fields must correspond to the entries found in the following registry key:
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\Perflib\<LangID>\Counter
where <LangID> corresponds to the specific entry for the default language on the machine (for example, 009 indicates that the language is English). If these values do not correspond, the counters and objects described for the service are not displayed correctly.