isApiSetImplemented 函数 (apiquery2.h)

IsApiSetImplemented 函数测试计算机上是否存在指定的 API 集

语法

APICONTRACT BOOL IsApiSetImplemented(
  PCSTR Contract
);

参数

Contract

指定要查询的 API 集的名称。 有关详细信息,请参阅“备注”部分。

返回值

如果存在指定的 API 集,IsApiSetImplemented 将返回 TRUE。 在这种情况下,目标 API 集中的 API 在当前平台上具有有效的实现。

否则,此函数返回 FALSE

注解

Windows 10的所有版本共享一个称为核心 OS (的 OS 组件的公共基础,在某些情况下,这也称为OneCore) 。 在核心 OS 组件中,Win32 API 组织成称为 API 集的功能组。

某些 API 集并非在所有Windows 10平台上都可用。 例如,尽管电脑上支持 Win32 API 的全部范围,但只有一部分 Win32 API 在其他设备(如 HoloLens、Xbox 和运行 Windows 10x 的其他设备)上可用。

编写同时面向桌面和非桌面Windows 10设备的代码时,请将 API 调用包装在 IsApiSetImplemented 中。 此函数在运行时测试 API 所属的 API 集是否存在于目标平台上。 有关详细信息,请参阅 检测 API 集可用性

若要确定给定的 Win32 API 是否属于 API 集,请查看 API 参考文档中的要求表。 如果 API 属于某个 API 集,则本文中的要求表将列出 API 集名称。

要求

要求
目标平台 Windows
标头 apiquery2.h
Library onecore.lib
DLL api-ms-win-core-apiquery-l2-1-0.dll

另请参阅

Windows API 集

检测 API 集可用性

针对 OneCore 生成

验证通用 Windows 驱动程序