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 的完整广度,但其他设备上(如 HoloLens、Xbox 和其他运行 Windows 10x 的设备)只提供 Win32 API 的子集。

编写面向桌面和非桌面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 驱动程序