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 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
Type: HRESULT
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.
Requirements
|
Minimum supported client | Windows 2000 Professional, Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server | Windows 2000 Server [desktop apps only] |
|
Header |
|
|
DLL |
|
Send comments about this topic to Microsoft
Build date: 11/28/2012
