Función IsApiSetImplemented (apiquery2.h)

Artículo
02/28/2024

La función IsApiSetImplemented comprueba si hay un conjunto de API especificado en el equipo.

Sintaxis

APICONTRACT BOOL IsApiSetImplemented(
  PCSTR Contract
);

Parámetros

Contract

Especifica el nombre del conjunto de API que se va a consultar. Para obtener más información, consulta la sección Comentarios.

Valor devuelto

IsApiSetImplemented devuelve TRUE si el conjunto de API especificado está presente. En este caso, las API del conjunto de API de destino tienen implementaciones válidas en la plataforma actual.

De lo contrario, esta función devuelve FALSE.

Comentarios

Todas las versiones de Windows 10 comparten una base común de componentes del sistema operativo que se denomina sistema operativo principal (en algunos contextos también se denomina OneCore). En los componentes principales del sistema operativo, las API de Win32 se organizan en grupos funcionales denominados conjuntos de API.

Algunos conjuntos de API no están disponibles en todas las plataformas de Windows 10. Por ejemplo, aunque la amplitud completa de la API de Win32 se admite en equipos, solo hay un subconjunto de la API de Win32 disponible en otros dispositivos, como HoloLens, Xbox y otros dispositivos que ejecutan Windows 10x.

Al escribir código que tenga como destino dispositivos de escritorio y no de escritorio Windows 10, encapsula la llamada API en IsApiSetImplemented. Esta función comprueba en tiempo de ejecución si el conjunto de API al que pertenece la API está presente en la plataforma de destino. Para más información, consulte Detección de disponibilidad de conjuntos de API.

Para identificar si una API de Win32 determinada pertenece a un conjunto de API, revise la tabla de requisitos de la documentación de referencia de la API. Si la API pertenece a un conjunto de API, la tabla de requisitos del artículo enumera el nombre del conjunto de API.