windows.h中的WINVER和_WIN32_WINNT警卫怎么了?

时间:2011-01-22 17:40:55

标签: windows visual-c++ winapi

Using the Windows Headers中,Microsoft声称_WIN32_WINNT和NTDDI_VERSION可用于防止为较新版本的Windows定义API函数。但是,这似乎并不普遍。

例如,CancelSynchronousIo需要Vista或更高版本,但在我拥有的两个版本的Windows SDK(v6.0和v7.1)中根本没有防范。

WINBASEAPI
BOOL
WINAPI
CancelIoEx(
    __in HANDLE hFile,
    __in_opt LPOVERLAPPED lpOverlapped
    );

与此同时,GetVolumeInformationByHandleW,也需要Vista,正如您所期望的那样得到保护:

#if(_WIN32_WINNT >= 0x0600)
WINBASEAPI
BOOL
WINAPI
GetVolumeInformationByHandleW(
    __in      HANDLE hFile,
    __out_ecount_opt(nVolumeNameSize) LPWSTR lpVolumeNameBuffer,
    __in      DWORD nVolumeNameSize,
    __out_opt LPDWORD lpVolumeSerialNumber,
    __out_opt LPDWORD lpMaximumComponentLength,
    __out_opt LPDWORD lpFileSystemFlags,
    __out_ecount_opt(nFileSystemNameSize) LPWSTR lpFileSystemNameBuffer,
    __in      DWORD nFileSystemNameSize
    );
#endif /* _WIN32_WINNT >=  0x0600 */

这种事情只是一个错误吗? _WIN32_WINT卫兵没用吗?任何人都可以推荐一种可靠的方法来确定哪个版本的Windows引入了哪些API?

已编辑添加:

这是一个测试。 foo.h包含:

#include <windows.h>

然后运行:

cl /E /D_WIN32_WINNT=0x0501 /DNTDDI_VERSION=0x05010000 foo.h | grep CancelSynchronousIo

我的期望是我没有输出,而是定义了CancelSynchronousIo。

1 个答案:

答案 0 :(得分:7)

这是一个错误。参考示例are herehere。一些次要证据表明Longhorn项目确实是一个非常困难的项目。 Windows团队没有像DevDiv那样接受反馈,很难修复错误。您可以在MSDN Library页面的底部留下注释。