IsApiSetImplemented-Funktion (apiquery2.h)

Artikel
08/22/2023

Die IsApiSetImplemented-Funktion testet , ob ein angegebener API-Satz auf dem Computer vorhanden ist.

Syntax

APICONTRACT BOOL IsApiSetImplemented(
  PCSTR Contract
);

Parameter

Contract

Gibt den Namen des API-Satzes an, der abfragen soll. Weitere Informationen finden Sie im Abschnitt Hinweise.

Rückgabewert

IsApiSetImplemented gibt TRUE zurück, wenn der angegebene API-Satz vorhanden ist. In diesem Fall verfügen APIs im Ziel-API-Satz über gültige Implementierungen auf der aktuellen Plattform.

Andernfalls gibt diese Funktion FALSE zurück.

Hinweise

Alle Versionen von Windows 10 verwenden eine gemeinsame Basis von Betriebssystemkomponenten, die als Kernbetriebssystem bezeichnet wird (in einigen Kontexten wird dies auch als OneCore bezeichnet). In kernen Betriebssystemkomponenten sind Win32-APIs in Funktionsgruppen organisiert, die als API-Sätze bezeichnet werden.

Einige API-Sätze sind nicht auf allen Windows 10 Plattformen verfügbar. Obwohl beispielsweise die gesamte Breite der Win32-API auf PCs unterstützt wird, ist nur eine Teilmenge der Win32-API auf anderen Geräten wie HoloLens, Xbox und anderen Geräten mit Windows 10x verfügbar.

Wenn Sie Code schreiben, der sowohl Desktopgeräte als auch Nicht-Desktopgeräte Windows 10, umschließen Sie den API-Aufruf in IsApiSetImplemented. Diese Funktion testet zur Laufzeit, ob der API-Satz, zu dem die API gehört, auf der Zielplattform vorhanden ist. Weitere Informationen finden Sie unter Erkennen der Verfügbarkeit von API-Sätze.

Um zu ermitteln, ob eine bestimmte Win32-API zu einem API-Satz gehört, lesen Sie die Anforderungstabelle in der Referenzdokumentation für die API. Wenn die API zu einem API-Satz gehört, enthält die Anforderungstabelle im Artikel den Namen des API-Satzes.