Funzione IsApiSetImplemented (apiquery2.h)

Articolo
03/09/2023

La funzione IsApiSetImplemented verifica se un set di API specificato è presente nel computer.

Sintassi

APICONTRACT BOOL IsApiSetImplemented(
  PCSTR Contract
);

Parametri

Contract

Specifica il nome dell'API impostato su query. Per altre informazioni, vedere la sezione Osservazioni.

Valore restituito

IsApiSetImplemented restituisce TRUE se il set di API specificato è presente. In questo caso, le API nel set di API di destinazione hanno implementazioni valide nella piattaforma corrente.

In caso contrario, questa funzione restituisce FALSE.

Commenti

Tutte le versioni di Windows 10 condividono una base comune di componenti del sistema operativo denominati sistema operativo di base (in alcuni contesti viene chiamato anche OneCore). Nei componenti principali del sistema operativo, le API Win32 sono organizzate in gruppi funzionali denominati set di API.

Alcuni set di API non sono disponibili in tutte le piattaforme Windows 10. Ad esempio, anche se l'intera ampiezza dell'API Win32 è supportata nei PC, solo un subset dell'API Win32 è disponibile in altri dispositivi come HoloLens, Xbox e altri dispositivi che eseguono Windows 10x.

Quando si scrive codice destinato sia ai dispositivi desktop che non desktop Windows 10, eseguire il wrapping della chiamata API in IsApiSetImplemented. Questa funzione verifica in fase di esecuzione se il set di API a cui appartiene l'API è presente nella piattaforma di destinazione. Per altre informazioni, vedere Rilevare la disponibilità del set di API.

Per identificare se un'API Win32 specificata appartiene a un set di API, esaminare la tabella dei requisiti nella documentazione di riferimento per l'API. Se l'API appartiene a un set di API, la tabella dei requisiti nell'articolo elenca il nome del set di API.