Export (0) Print
Expand All
Expand Minimize

DllGetVersion function

Implemented by many of the Windows Shell DLLs to allow applications to obtain DLL-specific version information.

Syntax


HRESULT CALLBACK DllGetVersion(
  DLLVERSIONINFO *pdvi
);

Parameters

pdvi

Type: DLLVERSIONINFO*

A pointer to a DLLVERSIONINFO structure that receives the version information. The cbSize member must be filled in before you call this 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

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This function is exported by name from each DLL that implements it. Currently, most of the Windows Shell and 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 to define a pointer to a DllGetVersion function. Use the pointer when calling the function dynamically by loading the library and getting the function's address. See Shell and Shlwapi DLL Versions for a detailed discussion of the different file versions, and how to use DllGetVersion.

Requirements

Minimum supported client

Windows 2000 Professional, Windows XP [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Shlwapi.h

DLL

Shell32.dll (version 4.71 or later)

 

 

Community Additions

ADD
Show:
© 2014 Microsoft