Click here to Skip to main content
15,867,834 members
Articles / Desktop Programming / MFC
Article

Accessing Windows 2000 specific APIs

Rate me:
Please Sign up or sign in to vote.
4.56/5 (9 votes)
28 Feb 2000 99.9K   25   15
Having trouble accessing the new Windows 2000 APIs? This article may help.

In order to access Win2000 specific APIs etc, one needs the following #define in the application's stdafx.h (before any other #includes)

#define _WIN32_WINNT 0x0500
With the latest platform SDK, this also has the side effect of changing the definition for the OPENFILENAME struct; in particular it makes it larger. This is because of the following lines in the "CommDlg.h"
typedef struct tagOFNA {
	DWORD        lStructSize;
	...
	...
	LPCSTR       lpTemplateName;
#ifdef _MAC
	LPEDITMENU   lpEditInfo;
	LPCSTR       lpstrPrompt;
#endif
#if (_WIN32_WINNT >= 0x0500)
	void *       pvReserved;
	DWORD        dwReserved;
	DWORD        FlagsEx;
#endif // (_WIN32_WINNT >= 0x0500)
} OPENFILENAMEA, *LPOPENFILENAMEA;

This means when the definition of class CFileDialog is compiled, it's m_ofn member will have a different size than in the MFC dlls. This is because CFileDialog is defined as:

class CFileDialog : public CCommonDialog
{
	DECLARE_DYNAMIC(CFileDialog)
	public:
	// Attributes
	OPENFILENAME m_ofn; // open file parameter block
	...
	...
};

When a CFileDialog is used in your code and is destructed, the wrong offsets into memory for member varialbes will be unsed, and in particular, the m_strFilter will not destruct properly.

The work-around for this is to #undef _WIN32_WINNT before the #include <afxext.h> in the application's stdafx.h:

#define _WIN32_WINNT 0x0500     // allow Win2000 specific calls
#define VC_EXTRALEAN            // Exclude rarely-used stuff from Windows headers
#include <afxwin.h>             // MFC core and standard components
#undef _WIN32_WINNT             // allow CFileDialog to build with the correct size
#include <afxext.h>             // MFC extensions
#include <afxdtctl.h>           // MFC support for Internet Explorer 4 Common Controls
#ifndef _AFX_NO_AFXCMN_SUPPORT
#include <afxcmn.h>             // MFC support for Windows Common Controls
#endif // _AFX_NO_AFXCMN_SUPPORT

Now, <afxext.h> will (indrectly) #include <CommDlg.h> and define CFileDIalog all without the offending _WIN32_WINNT.

NOTE: This only works because the VC_EXTRALEAN stops <afxwin.h> from including CommDlg.h earlier.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


Written By
United States United States
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
GeneralHelps also with CFileDialog Pin
arschimedes22-Feb-07 3:52
arschimedes22-Feb-07 3:52 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.