Implemented by many of the Microsoft Windows Shell DLLs to allow applications to obtain DLL-specific version information.
Syntax
HRESULT CALLBACK DllGetVersion(
DLLVERSIONINFO *pdvi
);
Parameters
- pdvi
A pointer to a DLLVERSIONINFO structure that receives the version information. The cbSize member must be filled in before calling the function.
Version 5.0. DLLs that are shipped with Windows 2000 or later systems may return a DLLVERSIONINFO2 structure. To maintain backward compatibility, the first member of a DLLVERSIONINFO2 structure is a DLLVERSIONINFO structure.
Return Value
Returns S_OK if successful, or a COM-defined error value otherwise.
Remarks
This function is not an API. It is exported by name from each DLL that implements it. Currently, most of the Windows Shell and common controls DLLs implement DllGetVersion. These include, but are not limited to, Shell32.dll, Comctl32.dll, Shdocvw.dll, and Shlwapi.dll.
To call this function, use the LoadLibrary and GetProcAddress functions to obtain the function pointer. The DLLGETVERSIONPROC type is used as the data type for the function pointer. This type definition is used to define a pointer to a DllGetVersion function. This pointer is used when calling the function dynamically by loading the library and getting the function's address. See Shell and Common Controls Versions for a detailed discussion of Shell and common controls versions, and how to use DllGetVersion.
Function Information
| Minimum DLL Version | shell32.dll version 4.71 or later |
|---|
| Custom Implementation | No |
|---|
| Header | shlwapi.h |
|---|
| Import library | None |
|---|
| Minimum operating systems |
Windows 2000, Windows NT 4.0 with Internet Explorer 4.0, Windows 98 |
|---|