Compiling Forefront TMG 2010 SDK Samples

[LEFT]The Software Development Kit (SDK) for Forefront Threat Management Gateway (TMG) 2010 is available for download from the Microsoft download center [URL="http://www.microsoft.com/downloads/details.aspx?FamilyID=8809cfda-2ee1-4e67-b993-6f9a20e08607&DisplayLang=en"]here[/URL].
We have received a number of questions about issues compiling the SDK samples and wanted to share a few tips with you.
[B]Preparing Your Environment[/B]

When compiling the SDK with Visual Studio 2008/2005, the MIDL compiler may fail with the following error:
[B]midl : error MIDL2379 : the compiler reached a limit for a format string representation. See documentation for advice. [/B]
To solve this issue, do the following:
a. Verify that Visual Studio 2005/2008 SP1 is installed (you can download VS 2005 SP1 from [URL="http://www.microsoft.com/downloads/details.aspx?FamilyId=BB4A75AB-E2D4-4C96-B39D-37BAF6B5B1DC&displaylang=en"]here[/URL] and VS 2008 SP1 from [URL="http://www.microsoft.com/downloads/details.aspx?familyid=FBEE1648-7106-44A7-9649-6D9F6D58056E&displaylang=en"]here[/URL] ).
b. Install the updated Windows 7 SDK, which contains a newer version of the MIDL compiler, using the instructions provided in [url=http://blogs.msdn.com/windowssdk/archive/2009/08/07/using-the-win-7-sdk-build-environment-with-vs-2008.aspx]Microsoft Windows SDK Blog : Using the Win 7 SDK Build Environment with VS 2008[/url]
[B]To build the samples for a 64 bit environment, do the following:[/B]

1. Make sure you’ve implemented the steps above. Failing to complete these steps will result in a MIDL compiler error on a 64 bit platform.
2. Start Visual Studio 2008.
3. Open the requested sample solution.
4. Complete the conversion wizard (to convert a Visual Studio 6.0 solution to a Visual Studio 2005/2008 solution).
5. By default, the solution targets a 32 bit environment. For Forefront TMG to work with this project you will need to change the target platform to 64 bit. Please follow these steps:

[LIST][*]Open the Visual Studio Configuration Manager by selecting Build->Configuration Manager.
[URL="http://blogs.technet.com/blogfiles/isablog/WindowsLiveWriter/CompilingForefrontTMG2010SDKSamples_F7DC/image_2.png"][IMG]http://blogs.technet.com/blogfiles/isablog/WindowsLiveWriter/CompilingForefrontTMG2010SDKSamples_F7DC/image_thumb.png[/IMG][/URL][*]Under “Active solution platform” select the “New…” option. A dialog box will open:
[URL="http://blogs.technet.com/blogfiles/isablog/WindowsLiveWriter/CompilingForefrontTMG2010SDKSamples_F7DC/image_4.png"][IMG]http://blogs.technet.com/blogfiles/isablog/WindowsLiveWriter/CompilingForefrontTMG2010SDKSamples_F7DC/image_thumb_1.png[/IMG][/URL][*]Select the new platform as x64. Verify that the other settings (‘Copy settings from’ and ‘Create new project platforms’) are selected the same as in the image above. Click OK, and close the Configuration Manager dialog box.[*]The solution now has the new x64 platform settings in place.[*]Save the solution to finalize this step.[*]Select Project -> Properties from the menu. In the dialog box, expand Configuration Properties, expand Linker and then select General. Make sure the output file settings are .\x64\Debug/WebResponseModifier.dll
[URL="http://blogs.technet.com/blogfiles/isablog/WindowsLiveWriter/CompilingForefrontTMG2010SDKSamples_F7DC/image_6.png"][IMG]http://blogs.technet.com/blogfiles/isablog/WindowsLiveWriter/CompilingForefrontTMG2010SDKSamples_F7DC/image_thumb_2.png[/IMG][/URL][*]Select Advanced. Make sure the Target Machine settings are set to Machine X64 (/Machine: X64)
[URL="http://blogs.technet.com/blogfiles/isablog/WindowsLiveWriter/CompilingForefrontTMG2010SDKSamples_F7DC/image_8.png"][IMG]http://blogs.technet.com/blogfiles/isablog/WindowsLiveWriter/CompilingForefrontTMG2010SDKSamples_F7DC/image_thumb_3.png[/IMG][/URL][*]Select Command Line. Make sure the Additional Option box is empty and does not include any directive (if you find the ‘/MACHINE:I386’ directive there – remove it).[*]Press OK to finalize changes.[/LIST]
6. You can now build the solution for the x64 bit platform.
[B]Sample specific information[/B]

1. Web filters

[LIST][*]WebExeBlock – When building the sample you may receive the following warning:
[B]WebExeBlockFilterImpl.cpp
[/B][B].\WebExeBlockFilterImpl.cpp(548) : warning C4068: unknown pragma
[/B]You may ignore the warning as it does not influence the code generation and the final outcome.[*][B]WebResponseModifier[/B] – when building the sample you may receive the following link error ([U]for both debug and release configurations[/U]):
[B]1>.\Debug\main.obj : fatal error LNK1112: module machine type 'x64' conflicts with target machine type 'X86'
[/B]This error happens due to conflicting linker directives. To solve this issue, right-click on the project and select Properties. Under Configuration Properties->Linker->Command Line you will find under Additional options the ‘/MACHINE:I386’ directive. This confuses the compiler because the directive appears twice – once with X64 and once with the I386 option.
[URL="http://blogs.technet.com/blogfiles/isablog/WindowsLiveWriter/CompilingForefrontTMG2010SDKSamples_F7DC/image_10.png"][IMG]http://blogs.technet.com/blogfiles/isablog/WindowsLiveWriter/CompilingForefrontTMG2010SDKSamples_F7DC/image_thumb_4.png[/IMG][/URL]
Remove the ‘/MACHINE:I386’ directive, press OK and compile the project again.
Note: you must do it twice – once for each build configuration (debug or release)[/LIST]
2. Application filters

[LIST][*]DataMonitor –
[B]i.[/B] When converting the project to Visual Studio 2008 you will get an error in the conversion process. You may ignore it and remove the redundant project (see image below):
[URL="http://blogs.technet.com/blogfiles/isablog/WindowsLiveWriter/CompilingForefrontTMG2010SDKSamples_F7DC/image_12.png"][IMG]http://blogs.technet.com/blogfiles/isablog/WindowsLiveWriter/CompilingForefrontTMG2010SDKSamples_F7DC/image_thumb_5.png[/IMG][/URL]

[B]ii.[/B] When building the sample you may receive the following compiler error:

[B]c:\program files (x86)\microsoft forefront tmg tools\sdk\samples\appfilters\datamonitor\admin\stdafx.h(42) : fatal error C1083: Cannot open include file: 'wspfwext.h': No such file or directory

[/B]To fix this issue, right-click on the “DataMonitorAdmin” project and select the Dependencies option. Make sure that the DataMonitor checkbox is checked:
[URL="http://blogs.technet.com/blogfiles/isablog/WindowsLiveWriter/CompilingForefrontTMG2010SDKSamples_F7DC/image_14.png"][IMG]http://blogs.technet.com/blogfiles/isablog/WindowsLiveWriter/CompilingForefrontTMG2010SDKSamples_F7DC/image_thumb_6.png[/IMG][/URL]
Clean and rebuild the solution again.

[B]iii.[/B] When building the sample you may receive the following compiler errors:

[B]1>Performing Custom Build Step
[/B][B]1>mc : error : 0x2 trying to open file <EventMsgs>.
[/B][B]1>Project : error PRJ0019: A tool returned an error code from "Performing Custom Build Step"

[/B]This error (in both debug and release configurations) happens due to a missing file extension in a custom build process. To solve this issue, right-click on the file EventMsgs.mc and select the Properties option. The dialog box (shown below) will appear.
[URL="http://blogs.technet.com/blogfiles/isablog/WindowsLiveWriter/CompilingForefrontTMG2010SDKSamples_F7DC/image_16.png"][IMG]http://blogs.technet.com/blogfiles/isablog/WindowsLiveWriter/CompilingForefrontTMG2010SDKSamples_F7DC/image_thumb_7.png[/IMG][/URL]
Under Custom Build Step, select Command Line and add the extension ‘.mc’, so it will show the following text: [B]mc $(InputName).mc
[/B]Click OK to close the dialog box and then right-click on the project and select Properties. Under Configuration Properties->Build Events->Post-Build Event, remove the regsvr32 command.
[URL="http://blogs.technet.com/blogfiles/isablog/WindowsLiveWriter/CompilingForefrontTMG2010SDKSamples_F7DC/image_18.png"][IMG]http://blogs.technet.com/blogfiles/isablog/WindowsLiveWriter/CompilingForefrontTMG2010SDKSamples_F7DC/image_thumb_8.png[/IMG][/URL]
Press OK and Compile the project.[/LIST]
[B][U]Author:[/U][/B]
Noam Ilovich, Program Manager
[B][U]Reviewers:
[/U][/B]Ori Yosefi, Senior Program Manager
Meir Feinberg, Technical Writer
[/LEFT]