Microsoft ® Windows ® SDK Release Notes for September
Customer Technology Preview
Version Sept CTP 1.0.0.1
1. Introduction
Welcome to the Microsoft ® Windows ®
Software Development Kit (SDK) for September Customer Technology Preview (CTP).
The Windows SDK contains documentation, samples, headers, libraries, and tools
designed to help you develop Microsoft ® Windows applications. The
documentation, samples, and tools provided in the Windows SDK support
application programming interfaces (APIs) available in the Windows Vista,
Microsoft ® Windows ® XP Service Pack 2 (SP2), and
Microsoft ® Windows ® Server 2003 Service Pack 1 (SP1)
versions of Windows. Not all API support all platforms. You can look under the
specific API documentation to determine which platform the API supports.
Important This version of the Windows SDK is available
as both a DVD ISO image that must be burned to a DVD or mounted as a virtual
drive and installed from that media, and as a web download.
The DVD ISO image of the Windows SDK available from Download
Center will not install the SDK directly on to your hard disk without the use of
additional tools. See the Installation Instructions below for more information.
The DVD ISO image requires a minimum of 1.5 GB of free disk space to install. If
you do not have that much free disk space, you can use the SDK's custom setup
options to install a subset of the content.
The web download is also available from the Download Center.
The web download will stream the SDK content to your local machine.
Important This version of the Windows SDK targets
specific versions of Windows and has other restrictions. This version:
- Is supported on Windows Vista September CTP, which is available from the
MSDN Universal Subscribers site on MSDN and from the Beta customer locations.
- Supports .NET Framework 3.0 September CTP for Windows XP SP2 and Windows
Server 2003 SP1, which is available publicly from the Download Center.
Important To optimize your Windows SDK setup experience, we strongly
recommend that you install the latest updates and patches from Microsoft
Update before you begin installing the Windows SDK.
Please note that this release is for preview purposes only. The APIs,
documentation, samples, headers, libraries, and tools provided in this release
are preliminary and subject to change.
- It is strongly recommended that you install this pre-release version of
the Windows SDK in a test environment, not a production environment. This
document identifies many known issues. Please read the Installation
Instructions and Known Issues sections before installing.
- To learn more about Known Issues and to find additional information about
Windows Vista, see The MSDN Online Windows Vista Developer Center. The Developer
Center is focused on keeping developers up-to-date on how they can take
advantage of Windows Vista's rich new client features in their applications.
Visit the Developer Center often to see new articles, read monthly columns,
participate in the Windows Vista Beta Newsgroups, download sample code and read
the Editor's Web Log.
Important When building samples, do so in a directory outside of
Program Files to which you have write access. For more information, see the
Samples section below.
You might also consider installing:
Microsoft .NET Framework 3.0:
http://msdn.microsoft.com/winfx/
and Windows PowerShell:
X86: http://go.microsoft.com/fwlink/?linkid=64772&clcid=0x409
X64:
http://go.microsoft.com/fwlink/?linkid=64773&clcid=0x409
IA64:
http://go.microsoft.com/fwlink/?linkid=65815&clcid=0x409
2. License Agreement
The contents included in the Windows SDK are licensed to
you, the end user. Your use of the SDK is subject to the terms of an End User
License Agreement ("EULA") accompanying the SDK and located in the \License
subdirectory. You must read and accept the terms of the EULA before you access
or use the SDK. If you do not agree to the terms of the EULA, you are not
authorized to use the SDK.
3. Supported Compiler, Platforms and Related Software
This pre-release of the Windows SDK supports the RTM
release of Microsoft
® Visual Studio
®2005. You can
download a copy at no charge from the
Visual
Studio 2005 Developer Center.
This pre-release of the Windows SDK supports x86, x64, and IA64 platforms for
building and running samples.
You might also consider installing Microsoft .NET Framework 3.0.
Microsoft .NET Framework 3.0 http://msdn.microsoft.com/winfx/
You might also consider installing Windows PowerShell.
X86: http://go.microsoft.com/fwlink/?linkid=64772&clcid=0x409
X64:
http://go.microsoft.com/fwlink/?linkid=64773&clcid=0x409
IA64:
http://go.microsoft.com/fwlink/?linkid=65815&clcid=0x409
4. File System Layout
By default, the Windows SDK is installed to your hard disk
in the locations described in the following table. This list is not complete,
but covers the most common directories.
Directory |
Contents |
\Bin |
Windows SDK tools |
\Help |
Windows SDK documentation |
\Include |
Windows SDK headers |
\Lib |
Import libraries and TLB files |
\License |
Windows SDK license information |
\Samples |
Windows SDK samples |
5. Installation Instructions
Please install on a clean machine or completely
uninstall any pre-releases of the Microsoft
® WinFX
®
Runtime Components 3.0, the WinFX SDK, the Platform SDK, the Windows SDK, the
.NET Framework redistributable, Microsoft
® Visual Studio
® , and their dependencies before installing this release. These older
components may interfere with this release, causing setup to fail or break
functionality. We recommend installing this version on non-production machines
(preferably in a test environment) without these previous releases to prevent
incompatibilities.
To install on Microsoft Windows XP Service Pack 2 or Microsoft Windows
2003 Server Service Pack 1:
- If you intend to install .NET Framework 3.0 components available in the
Windows SDK, install the .NET Framework 3.0 September Customer Technology
Preview from the Download Center. Note If you download the DVD ISO
image, burn the image to a DVD or mount as a virtual drive and install the SDK
on your local hard disk. The details page for the Windows SDK in the Download
Center has additional information about tools you can use to create the setup
image without burning the image to a DVD. You can also install the Windows SDK
by using web setup.
- If you create a DVD ISO image or mount a virtual drive and launch
setup.exe, choose the appropriate option to install the Windows SDK Insert the
SDK DVD into a DVD-ROM drive and click setup.exe, or after the virtual drive
is mounted, launch the setup.exe from within that virtual drive.
- Follow the instructions in the Windows SDK Setup wizard.
- Optional Install Microsoft ® Visual Studio ®
2005.
- Optional Install the Visual Studio 2005 Extensions for .NET
Framework 3.0 from the Download Center.
The .NET Framework 3.0 is available by default in Windows Vista.
NoteIf you intend to use Visual Studio to develop .NET Framework 3.0
applications, you must install the Windows SDK before installing the Visual
Studio 2005 Extensions for .NET Framework 3.0. It is essential that you use the
version of Visual Studio identified in the Installation Instructions in .NET
Framework 3.0 setup.
Access the Windows SDK through the Start menu at Microsoft Windows SDK. The
Start menu folder contains pointers to the documentation (which contains the
samples for .NET Framework 3.0), tools, debug and release build environments.
Documentation for the Windows SDK is also available on MSDN Online at http//windowssdk.msdn.microsoft.com/library.
6. Known Issues
This release has the following known issues. Known issues
are categorized by content type.
6.1 Setup and General Development
6.1.1 Windows SDK Disk Space Requirements
The complete DVD ISO installation of the Windows SDK
requires 1.5 GB or more disk space to install successfully. Please verify that
the computer you are installing to has at least the minimum required disk space
before beginning setup. If the minimum required disk space is not available,
setup will return a fatal error.
6.1.2 Several SDK Components Must be Uninstalled Separately in Add/Remove
Programs
The Windows SDK installs both its core components and
external applications as separate MSI files. Please note that several
applications will need to be uninstalled from Add/Remove Programs in order to
remove all SDK components. Those components are:
- Debugging Tools for Windows
- Microsoft Windows Software Development Kit
- Microsoft Windows Software Development Kit Headers and Libraries
- Microsoft .NET Compact Framework 2.0
- Microsoft FxCop 1.3.5
- Windows PowerShell
Due to SDK componentization, we recommend re-running the SDK setup.exe from
your download location and choosing which features to install. For example, if
you choose "Microsoft Windows Software Development Kit" from Add/Remove Programs
and then "Change," you will see a different screen that does not show all the
internal and external content installed as MSI files.
If you originally only installed the x86 development environment and now want
to install the x64 development environment, you need to relaunch the SDK
setup.exe versus launching the "Change" functionality for the "Microsoft Windows
Software Development Kit" located in Add/Remove Programs in the Control
Panel.
6.1.3 VSS Software Provider ID is required to Use Some APIs
The VSS Software Provider ID is needed to use various APIs,
including the shadow copy storage management interfaces (IVSSSnapshotMgmt).
To add this provider ID, define a const GUID and use that in your code.
// {b5946137-7b9f-4925-af80-51abd60b20d5}
static const GUID VSS_SWPRV_ProviderID =
{ 0xb5946137, 0x7b9f, 0x4925, { 0xaf, 0x80, 0x51, 0xab, 0xd6, 0x0b,
0x20, 0xd5 } };
In a few cases, you may need to use the Software Provider GUID to access some
APIs (GetProviderMgmtInterface method on the IVSSSnapshotMgmt interface.
Vssadmin list providers can also obtain the GUID.
6.1.4 Known issues with Windows Workflow Foundation (WF)
There are a few known issues with Windows Workflow
Foundation (WF) in this SDK release. See the online
Microsoft .NET Framework 3.0 Readme for a complete list.
6.1.5 Visual Studio 2005 is Required for .NET Compact Framework
Development
The SDK provides documentation and sample code that targets
the .NET Compact Framework. However, actual development of .NET Compact
Framework applications requires Visual Studio 2005.
6.1.6 Windows Presentation Foundation Imaging Component Does Not Support
Metadata That Spans Multiple APP Segments
JPEG APP headers do not support metadata segments larger
than 64K. The Windows Presentation Foundation Imaging Component does not support
metadata that spans multiple APP segments. If you add a color profile larger
than 64K to the APP2 metadata marker of a JPEG image, the color profile may
become corrupt if the image or the metadata are modified.
There is no workaround for this issue.
6.2 Build Environment
The following section describes and offers possible
workarounds for known issues with compilers and known issues with headers and
libraries included in the Windows SDK.
6.2.1 Headers and Libraries: Using the Windows SDK to Develop Win32 C++
Applications With Visual Studio 2005
In order to utilize Windows SDK headers, libraries, and
tools within Visual Studio 2005, the SDK-provided Visual Studio registration
tool must first be run. The Visual Studio registration tool must run in elevated
administraor mode on a Windows Vista computer. When running this tool on a
Windows Vista machine it must be run for each user.
To run the Visual Studio Registration Tool, go to
Start --> All Programs --> Microsoft Windows SDK --> Visual Studio
Registration--> Register Windows SDK Directories with Visual Studio
2005.
6.2.2 Compilers: The J# Compiler is Not Available in This Version of the
Windows SDK
J# samples will not build using the Windows SDK because
there is no appropriate build environment.
There is no workaround. This edition of the Windows SDK does not support
building J# applications.
6.2.3 Compilers: Debugging Windows Presentation Foundation (WPF)
Applications with Kernel Debugger Active May Result In an Error
When debugging WPF applications, the following error
message may appear:
Debugging is not possible because a kernel debugger is enabled on the
system.
This message occurs while debugging managed code on a system running
Windows ® NT, Windows ® 2000, or Windows XP that has been
started in debug mode.
6.2.4 Msbuild Reports a Dependency upon the Microsoft .NET Framework SDK
2.0
The Windows SDK does not set the
HKLM\Software\Microsoft\.NETFramework\sdkInstallRootv2.0 registry key to a
string value containing the root directory of the Windows SDK installation.
However, some MSBuild tasks may expect this registry key to be set. If you
already have the .NET Framework SDK 2.0 or Visual Studio 2005 set this key would
be set and you should not encounter a problem. However, if you install the
Windows SDK without either the .NET Framework SDK or Visual Studio 2005, you may
receive an error message from MSBuild tasks with a dependency on this key.
To work around this issue set the string value of this key to the root
directory of the Windows SDK installation. By default, this is: C:\Program
Files\Microsoft SDKs\Windows\v6.0
6.3 Documentation
6.3.1 Some Links Are Broken In the SDK Documentation
Some links in the class library and other areas of SDK
documentation are broken. These will be fixed in future releases. There is no
workaround for this issue.
6.3.2 No “How Do I” Articles Are Available From the Windows SDK
Documentation Viewer
The How Do I feature might be removed in a future release.
There is no workaround for this issue.
6.3.3 Some In-Page Language Filter Options May Filter Out Required Syntax
Blocks in WPF Reference Pages
In some cases, both XAML and either C# or VB code are
required to successfully build and run samples. Applying either the C#, VB, or
XAML filters alone may exclude necessary syntax from the page view. This is
currently by design, and the design may be revisited in a later release.
6.3.4 Some Filters May Not Work As Expected
Filters may not work as expected. This is a known issue and
will be fixed in a future release.
6.3.5 WM_GETDLGCODE now uses wParam parameter.
Previously, the wParam parameter of the WM_GETDLGCODE
notification was not used. That parameter now indicates a virtual key pressed by
the user. It is important that the handler to react to this parameter. For
example, the handler could selectively handle VK_RETURN, but delegate VK_TAB to
the owner window.
6.3.6 WmpBitmapEncoder Property Type Changes
A late change to the code has changed the WmpBitmapEncoder
properties HorizontalTileSlices and VerticalTileSlices from a System.UInt16 to a
System.Int16 value for CLS compliance.
6.4 SDK Tools
This section describes known issues with Windows SDK tools
and possible workarounds.
6.4.1 Windows Powershell Can Be Downloaded Directly
Windows PowerShell was available to customers and partners
as a part of the Windows SDK. This is no longer the case. Now, Windows
PowerShell can be downloaded directly.
For more information, see the
Windows
PowerShell team blog.
6.4.2 Tb3x.Exe Has Been Deprecated and Removed From the Windows SDK
Tb3x.exe has been deprecated and removed from the Windows
SDK. There is no known workaround for this issue.
6.4.3 The Application Verifier tool is Not Available in the Windows SDK
The Application Verifier tool is not available in the
Windows SDK. It ships as part of the Windows Application Compatibility Toolkit.
To work around this issue, download the Windows Application Compatibility
Toolkit from Download Center.
6.4.4 Uispy.Exe Fails to Run and Displays a Strong Name Validation
Error
UISpy sometimes fails to run and displays a strong name
validation error.
This error occurs because UISpy.exe was delay signed and never resigned. By
default, this causes the .NET runtime to fail the execution of UISpy.exe because
the strong name signature in the executable is not valid. However, UISpy will
run correctly if you configure the runtime to ignore the strong name signature
for UISpy.exe.
To work around this issue, register UISpy.exe for strong name verification
skipping.
1. Open a Windows SDK command prompt.
2. Navigate to the /bin directory. By default, this is C:\Program
Files\Microsoft SDKs\Windows\v1.0\bin.
3. Run the command SN -Vr UiSpy.exe . For example:
C:\Program Files\Microsoft SDKs\Windows\v1.0\Bin>sn -Vr
UiSpy.exe
The successfully run command will produce a message indicating that the
verification entry was added for the UISpy assembly.
6.4.5 Possible Application Exception after Removing localIssuer Address
Using SvcConfigEditor.exe
If you use SvcConfigEditor.exe to delete the address value
in the localIssuer element of clientCredential in the WCF Endpoint Behavior, the
tool will create an invalid configuration file and your application will throw
an exception. This is because SvcConfigEditor.exe doesn’t remove localIssuer
when the localIssuer value is an empty string (an unexpected value).
To work around this issue, manually remove the localIssuer element using
some other editor, such as Notepad.
6.4.6 SvcTraceViewer.exe Does Not Display Arabic Characters Correctly
In traces that contain Arabic characters, the XML view in
SvcTraceViewer.exe may render the characters in reverse order.
To work around this issue use the Formatted View, which displays the
traces in the correct character order. You can also copy the text from the XML
view and paste it into some other editor that displays the characters in the
correct order.
6.4.7 Managed C++ Code Generated Using SvcUtil.exe Tool May Not Compile
You can use the SvcUtil.exe tool to generate code for web
service proxies and data types from metadata. However, there are known issues
with the C++ code provider in Visual Studio 2005 and the .NET Framework 2.0 SDK
that can cause the tool to generate Managed C++ code that may not compile.
6.4.8 Code Generation Language Support in SvcUtil.exe
SvcUtil.exe can generate code for web service proxies and
data types from metadata in any language that has a managed code provider.
SvcUtil.exe has been tested with the C#, Visual Basic, and C++ managed code
providers. Other code providers have not been tested and may generate code that
does not compile or may be otherwise unusable.
6.4.9 SvcConfigEditor.exe Reloads the Config File When It Is Changed by
Another Entity
If you’re using SvcConfigEditor.exe to edit a config file
and another process or editor accesses that file, SvcConfigEditor.exe will
automatically reload the file. For example, this can happen when anti-virus
software scans the config file. The reload will cause you to lose any changes
made to the config file since SvcConfigEditor.exe last saved it.
To work around this issue, make sure SvcConfigEditor.exe is the only
process that accesses the file during a session.
6.5 Samples
This section describes known issues with Windows SDK
samples and possible workarounds.
Note Some .NET Framework 3.0 samples have specific dependencies or
setup requirements. If you find that a sample in the samples .zip files is not
working properly, first check the sample page in the documentation for
instructions.
6.5.1 Building Samples from a Directory Other Than the Sample Directory
When building Samples, do so in a directory outside of
Program Files to which you have write access. To build from the command line:
1.Open either the CMD Shell or PowerShell command prompt.
2.Copy the sample to a working folder not under Program Files. Copying to a
location other than Program Files makes it possible to maintain a pristine copy
of the samples installed by the SDK as well as avoid issues when writing to
files and directories located under Program Files.
3.Build the sample from the command line as follows:
-
Build a makefile by typing nmake.
-
Build a .csproj file by typing msbuild mysample.csproj.
-
Build a .vbproj file by typing msbuild mysample.vbproj.
-
Build a .vcproj by typing vcbuild
mysample.vcproj.
6.5.2 Not All C++ Samples with Visual C++ 2005 Project Files Have
Configurations for X64
Not all samples with Visual C++ 2005 project files have
configurations to build for X64. To workaround this just load the sample in
Visual C++ 2005 and update Configuration Manager under Project | Properties.
Additionally, if you do not install libraries for all CPU architectures, some
samples with Visual C++ 2005 project files may fail to build (link fails with
"fatal error LNK1181: cannot open input file") for all configurations in the
project file. For example, if a sample has an x86 configuration and no x86
libraries were installed (the default install setting when installing the SDK on
a X64 machine), that sample's x86 configuration will fail to build.
6.5.3 Where to Find .NET Framework 3.0 Samples
Samples demonstrating .NET Framework 3.0 can be found
individually in the SDK documentation. Each sample has its own description page.
From each sample page, you can view the source files for those samples as well
as individually download all the files of that sample to a chosen location. The
.NET Framework 3.0 samples can be accessed in bulk by directly opening the
sample .zip files located in %MSSDK%\Samples.
6.5.4 Building an Application with the SDK and ATL or MFC
The following samples require Visual Studio 2005 to build
either because an ATL or MFC header is required that Visual Studio 2005 ships.
The SDK does not come with either ATL or MFC headers, libraries, or runtimes.
However, if you have Visual C++ 2005 (non-Express editions) installed on your
system, you can use the SDK to build using ATL or MFC.
1. Open an SDK command window.
2. Type cd %MSSDK%\Setup .
3. Run VCIntegrate.exe .
4. From this point forward, command windows will now have the proper
environment settings to build an application that takes advantage of the
SDK.
Note If you want to disable support, run VCIntegrate /u to
uninstall
changes and return to command windows with no ATL or MFC
support.
The following samples require an ATL or MFC header that Visual Studio 2005
ships, but the Windows SDK does not ship.
- \com\administration\explore.vc
- \multimedia\audio\aecmicarray
- \multimedia\audio\multichan\
- \multimedia\gameux
- \multimedia\gdi\icm\devicemodelplugin
- \multimedia\gdi\icm\gamutmapmodelplugin
- \multimedia\wia\getimage
- \multimedia\windowsmediaservices9\authentication
- \multimedia\windowsmediaservices9\cacheproxy\cplusplus
- \multimedia\windowsmediaservices9\datasource
- \multimedia\windowsmediaservices9\eventnotification
- \multimedia\windowsmediaservices9\playlist
- \multimedia\wpd\wpdapisample
- \netds\adsi\samples\activedir\propsheethost\
- \netds\adsi\samples\dsui\scpext\scpcmenu\
- \netds\adsi\samples\dsui\scpext\scpproppage\
- \netds\adsi\samples\dsui\scpext\scpwizard\
- \netds\adsi\samples\dsui\userext\userproppage\
- \netds\adsi\samples\dsui\userext\userwizard\
- \netds\adsi\samples\general\adqi\
- \netds\adsi\samples\general\adserror\
- \netds\adsi\samples\general\adsidump\
- \netds\eap\eaphost
- \netds\fax\devicesetting\
- \netds\fax\faxaccount\
- \netds\fax\faxjoboperations\
- \netds\fax\faxreassign\
- \netds\fax\faxsecurity\
- \netds\fax\foldersenum\
- \netds\fax\outboundrouting\
- \netds\fax\routingextension\
- \netds\fax\sendfax\
- \netds\fax\serverconfig\
- \netds\messagequeuing\c_draw
- \netds\messagequeuing\imp_draw\
- \netds\messagequeuing\mqapitst
- \netds\messagequeuing\mqapitst\
- \netds\messagequeuing\mqf_draw
- \netds\messagequeuing\mqpers\
- \netds\nap\sdkqec
- \netds\nap\shv
- \netds\netmon\experts\blrplate\
- \netds\ras\customdial\
- \netds\ras\phoneentry\
- \netds\rras\eap\
- \netds\rtc\client\cpp\rtcincoming\
- \netds\rtc\client\cpp\rtcoutgoing\
- \netds\rtc\client\cpp\rtcsample\
- \netds\tapi\tapi3\cpp\msp\samplemsp\
- \netds\tapi\tapi3\cpp\pluggable\
- \netds\upnp\dco_dimmerservice\
- \netds\upnp\genericucp\cpp\
- \netds\upnp\registerdevice\
- \netds\wlan\autoconfig
- \security\authorization\azman\azmigrate
- \security\capicom\cpp\isapicertpolicy
- \security\certservices\exit\c++\windows.net\
- \security\certservices\exit\c++\windows2000\
- \security\certservices\policy\c++\windows.net\
- \security\certservices\policy\c++\windows2000\
- \security\credentialprovider
- \tabletPC\advreco\cpp
- \tabletPC\basicinkanalysis\cpp
- \tabletPC\tpcinfo\cpp
- \web\bits\bits_ie\
- \web\bits\upload\
- \web\iis\components\cpp\intermediate
- \web\iis\components\cpp\simple\
- \web\iis\rsca
- \web\networking\asyncdemo\
- \winbase\cluster\win2003\clipbookserver\clipbook serverex\
- \winbase\cluster\win2003\filesharesample\file share sampleex\
- \winbase\rdc
- \winbase\storage\optical\imapi2sample
- \winbase\vss\vshadow
- \winbase\vss\vsssampleprovider
- \winbase\wtsapi\wtsapi\
- \winui\globaldev\cssamp\
- \winui\globaldev\globaldev\
- \winui\muisampleapp
- \winui\pictures\acquisitionplugin
- \winui\pictures\pictureacquisition
- \winui\pictures\pictureacquisitionplugin
- \winui\shell\columnprovider\
- \winui\shell\shelliconoverlay\
- \winui\sideshow\pictures\
- \winui\sideshow\tasks\
- \winui\tsfapp\
- \winui\tsfcompart\
6.5.5 Must Install Peer Networking Feature on Microsoft Windows XP SP2
Before Running WCF Peer Channel Samples
The documentation for three of the WCF samples is missing
instructions on how to install the Peer Name Resolution Protocol (PNRP) on a
computer running Windows XP SP2. These samples are:
- Net Peer TCP Sample
- Peer Channel Secure Chat Sample
- Peer Channel Custom Authentication Sample
To install PNRP on Windows XP SP2 (one-time setup):
1. In Control Panel, double click Add or Remove Programs.
2. In the Add or Remove Programs dialog box, click Add/Remove Windows
Components.
3. In the Windows Components Wizard, select the Networking Services check
box, and then click Details.
4. Check the Peer-to-Peer check box and click OK.
5. Click Next in the Windows Components Wizard.
6. When installation completes, click Finish.
7. From a command shell, start the PNRP service using the following
command
net start pnrpsvc
6.5.6 Some Netds/Peer To Peer Samples Need To Be Run From A Non-Elevated
Window
The following samples cannot be run from an elevated
window:
- Contacts
- Invitation
- People Near Me
To work around this issue, run these applications from a non-elevated
window.
6.5.7 Run Error in Windows Presentation Foundation Blackjack Demo
Sample
The Windows Presentation Foundation Blackjack demo sample
has a known platform animation issue. When a card is drawn for either the player
or the dealer, it may end up being placed on the source deck, rather than the
player’s or dealer’s deck about 10% of the time. There is no workaround.
6.5.8 Need to Change Visual Studio 2005 Project Files
When building in Visual Studio 2005, the project files for
the following .NET Framework 3.0 samples only support building for Win32 | Debug
only after you actively select that configuration. The other configurations do
not correctly build.
- BEREncoding
- Dsml_BatchRequest
- Dsml_Exceptions
- Dsml_PagedSearch
- Dsml_ReadRootDSE
- Dsml_SendRequest
- Ldap_AsyncSend
- Ldap_Exceptions
- Ldap_PagedSearch
- Ldap_PrintDomain
- Ldap_ReadRootDSE
- Ldap_Referral
- Ldap_SendRequest
6.5.9 The SchemaReader Sample Requires Windows Media Player 11
The Windows Media Player SchemaReader sample requires
Windows Media Player 11 to be installed.
6.5.10 Digital Signal Processing (DSP) Plug-Ins Created By the Windows Media
Player Plug-In Wizard Might Not Work With Windows Media Player 11
Digital signal processing (DSP) plug-ins created using the
Windows Media Player plug-in wizard are single-threaded. This release of Windows
Media Player 11 requires that DSP plug-ins be multi-threaded. Attempting to load
a single-threaded DSP plug-in into Windows Media Player 11 may yield unexpected
results.
Microsoft is aware of this issue and is working to provide support for
existing single-threaded DSP plug-ins in future releases of Windows Media Player
11.
6.5.11 Windows Media Player Online Store Plug-In Wizard Does Not Create Type
1 Plug-Ins
The Windows Media Player online store plug-in wizard can be
used to create a plug-in for a type 2 online store, but it cannot be used to
create a plug-in for a type 1 online store.
Microsoft is aware of this issue and is working to provide support for type 1
plug-ins in a future release of the wizard. To work around this issue, you can
create a type 1 plug-in manually.
6.5.12 MMC 3.0 Samples Require that MMC 3.0 is Installed
When the Windows SDK is installed on an x86 Windows Server
2003 SP1 machine, MMC 3.0 samples do not compile. To work around this issue,
install MMC 3.0 components.
6.5.13 The Security Certificate Services Ocspsample Does Not Build On or For
Windows Vista
There is no workaround for this issue.
6.5.14 The Following Windows Media 9 Samples Require Additional Steps to
Build
The following samples require additional steps to build:
- \Samples\Multimedia\WindowsMediaServices9\Logging
- \Samples\Multimedia\WindowsMediaServices9\CacheProxy\csharp
To build the Logging and CacheProxy samples:
- Load each of the samples' .sln file into Visual Studio 2005 and allow it
to upgrade the project.
- Add a reference to microsoft.windowsmediaservices.dll by going to Project
| Add Reference... | Browse and then browse to the SDK's include directory and
select microsoft.windowsmediaservices.dll and click OK.
- Build the solution.
6.5.15 The Following TAPI Samples Depend Upon the Directshow
Baseclasses
The following TAPI samples depend upon the DirectShow
BaseClasses (found in the SDK Sample directory). If the sample directory is not
installed to the default location, the makefile for the following samples will
need to be adjusted to refer to the new location:
- \netds\tapi\tapi3\cpp\pluggable
- \netds\tapi\tapi3\cpp\tapirecv
- \netds\tapi\tapi3\cpp\tapisend
6.5.16 The 3d9exsample Sample Requires DirectX SDK to Build
The sample multimedia\direct3d\d3d9exsample requires the
DirectX SDK be installed and the INCLUDE and LIB environment variables updated
to build. The DirectX SDK include directory should be appended to the INCLUDE
environment variable, from within a SDK command prompt. Additionally the DirectX
SDK library directory also must be appended to the LIB environment variable,
from within a SDK command prompt. This will allow the sample to be built using
the supplied makefile.
6.5.17 Samples Needing Adminstrative Priviledge to Build
The following samples need administrative priviledge to
build on Windows Vista:
- multimedia\windowsmediaservices9\authentication
- multimedia\windowsmediaservices9\authorization
- multimedia\windowsmediaservices9\eventnotification
- multimedia\windowsmediaservices9\cacheproxy\cplusplus
- multimedia\windowsmediaservices9\datasource
- multimedia\windowsmediaservices9\playlist
- web\iis\components\cpp\intermediate
- winbase\rdc
6.5.18 WMI Decoupled Sample Missing precomp.h
The sample sysmgmt\wmi\vc\decoupled reports that the file
precomp.h is missing and thus fails to build. The file precomp.h is located in
sysmgmt\wmi\vc\decoupled and should instead be located under
sysmgmt\wmi\vc\decoupled\include in order for the sample to build.
6.5.19 Cross-Technology Sample Build Issues
Two "Cross-Technology" samples have build issues.
- SafePad does not build with the current version of the SDK.
- RecipeViewer ConsoleHost.exe builds, but does not run. The workaround is
to open the configuration file app.config in the ConsoleHost project and
delete any attributes or elements that are related to the behaviors element,
then rebuild sample.
6.5.20 WCF Samples Setup Batch File May Not Work with IIS7
The WCF samples setup script, Setupvroot.bat, works on
Windows Vista only if you have Internet Information Services (IIS) 6.0
compatibility installed. To do this, either use the manual setup instructions
provided in the SDK or set up IIS 6.0 compatibility by doing the following:
- Click the Start button and select Control Panel.
- Select Programs in the Control Panel dialog.
- Select Turn Windows Features on or off.
- The User Account Control dialog is displayed. Click Continue.
- The Windows Features dialog is displayed. Expand the item labeled Internet
Information Services.
- Expand the item labeled World Wide Web Services.
- Expand the item labeled Application Development Features.
- Make sure the following items are selected:
- .Net Extensibility
- ASP.NET
- ISAPI Extensions
- ISAPI Filters
- Expand the item labeled Web Management Tools and make sure IIS Management
Console is selected.
- Expand the item labeled IIS 6 Management Compatibility and make sure IIS 6
Scripting Tools is selected (other options auto-select when you do this).
- Click OK.
6.5.21 Where to Get Working Versions of WCF Samples That Do Not Build or
Have Errors
The following WCF samples do not build in the Windows SDK
September CTP. Go to
http://wcf.netfx3.com/
using the links in the following table to get versions that build.
The TechnologySamples\Extensibility\Transport\Udp\CS sample hangs on
client.Close(). The working version of the sample is available at http://wcf.netfx3.com/files/folders/transport_channels/entry5235.aspx.
The Basic\Binding\WS\MessageSecurity\Username\*\Web.config has an incorrect
value for the serviceCertificate findValue attribute. The full line should read:
<serviceCertificate findValue="localhost" storeLocation="LocalMachine"
storeName="My" x509FindType="FindBySubjectName" />
A full refresh of all WCF samples is available at http://wcf.netfx3.com/content/resources.aspx
under "Documentation Updates."
7. Windows SDK Product Support
The pre-release Windows SDK is provided "as-is" and is not
supported by Microsoft. If you have questions or need assistance,
several
newsgroups are available to help you. If you have questions or need
assistance, see
The MSDN Online
Windows Vista Developer Center and the
Windows Vista
Beta Newsgroups for additional information and updates to the known issues.
8. Feedback
Your feedback is important to us. Your participation and
feedback through the
Windows Vista Beta
Newsgroups is appreciated.
Copyright © 2006 Microsoft Corporation. All rights reserved. Legal
Notices.