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