INFO: Export Registry Value Type for a Performance Extension DLL

Article translations Article translations
Article ID: 296481 - View products that this article applies to.
This article was previously published under Q296481
This article has been archived. It is offered "as is" and will no longer be updated.
Expand all | Collapse all

SUMMARY

This article describes the registry value that is retrieved by the operating system and passed to the Open function of a performance extension DLL.

MORE INFORMATION

The Performance Library (PerfLib), which is contained within the system file Advapi32.dll, is responsible for calling the Open function of a performance extension DLL. PerfLib calls the Open function within a performance extension DLL when an application first connects to the registry to collect performance data. This Open function typically performs the initialization required for the library to provide performance data.

The following is the function prototype for the exported Open function in a performance extension DLL:
DWORD CALLBACK <OpenPerformanceData>(LPWSTR lpDeviceNames);

where the name <OpenPerformanceData> is merely a placeholder for an application-defined name.
When the system calls this Open function, the lpDeviceNames argument will point to a buffer containing the Unicode strings that are stored in the Export value within the following registry key:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Application_Name\Linkage
On Microsoft Windows NT 4.0, PerfLib accepts any registry type for the Export value. However, on Microsoft Windows 2000 and Microsoft Windows XP, the type of the Export value must be either REG_SZ or REG_MULTI_SZ. If there are multiple strings, they should be separated by a UNICODE_NULL and terminated by two UNICODE_NULL characters. If the Export value does not conform to this specification on Windows 2000 and Windows XP, the Open procedure of a performance extension DLL will be called with NULL for the lpDeviceNames parameter.

Properties

Article ID: 296481 - Last Review: February 27, 2014 - Revision: 4.3
APPLIES TO
  • Microsoft Win32 Application Programming Interface, when used with:
    • the operating system: Microsoft Windows 2000
    • the operating system: Microsoft Windows XP
Keywords: 
kbnosurvey kbarchive kbapi kbinfo kbkernbase kbperfmon KB296481

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com