Fonction IsApiSetImplemented (apiquery2.h)

Article
02/28/2024

La fonction IsApiSetImplemented teste si un jeu d’API spécifié est présent sur l’ordinateur.

Syntaxe

APICONTRACT BOOL IsApiSetImplemented(
  PCSTR Contract
);

Paramètres

Contract

Spécifie le nom du jeu d’API à interroger. Pour plus d’informations, consultez la section Remarques.

Valeur retournée

IsApiSetImplemented retourne TRUE si le jeu d’API spécifié est présent. Dans ce cas, les API du jeu d’API cible ont des implémentations valides sur la plateforme actuelle.

Sinon, cette fonction retourne FALSE.

Remarques

Toutes les versions de Windows 10 partagent une base commune de composants du système d’exploitation appelé système d’exploitation principal (dans certains contextes, il est également appelé OneCore). Dans les composants de système d’exploitation principaux, les API Win32 sont organisées en groupes fonctionnels appelés ensembles d’API.

Certains jeux d’API ne sont pas disponibles sur toutes les plateformes Windows 10. Par exemple, bien que la largeur complète de l’API Win32 soit prise en charge sur les PC, seul un sous-ensemble de l’API Win32 est disponible sur d’autres appareils tels que HoloLens, Xbox et d’autres appareils exécutant Windows 10x.

Lors de l’écriture de code qui cible à la fois les appareils de bureau et non de bureau Windows 10, encapsulez l’appel d’API dans IsApiSetImplemented. Cette fonction teste au moment de l’exécution si le jeu d’API auquel appartient l’API est présent sur la plateforme cible. Pour plus d’informations, consultez Détecter la disponibilité des ensembles d’API.

Pour déterminer si une API Win32 donnée appartient à un ensemble d’API, consultez le tableau des exigences dans la documentation de référence de l’API. Si l’API appartient à un ensemble d’API, le tableau des exigences de l’article répertorie le nom de l’ensemble d’API.