Função IsApiSetImplemented (apiquery2.h)

Artigo
03/05/2024

A função IsApiSetImplemented testa se um conjunto de API especificado está presente no computador.

Sintaxe

APICONTRACT BOOL IsApiSetImplemented(
  PCSTR Contract
);

Parâmetros

Contract

Especifica o nome do conjunto de APIs a ser consultado. Para obter mais informações, consulte a seção Comentários.

Retornar valor

IsApiSetImplemented retornaráTRUE se o conjunto de API especificado estiver presente. Nesse caso, as APIs no conjunto de APIs de destino têm implementações válidas na plataforma atual.

Caso contrário, essa função retornará FALSE.

Comentários

Todas as versões do Windows 10 compartilham uma base comum de componentes do sistema operacional que é chamada de sistema operacional principal (em alguns contextos, isso também é chamado de OneCore). Nos principais componentes do sistema operacional, as APIs do Win32 são organizadas em grupos funcionais chamados conjuntos de API.

Alguns conjuntos de API não estão disponíveis em todas as plataformas Windows 10. Por exemplo, embora a amplitude total da API Win32 tenha suporte em computadores, apenas um subconjunto da API Win32 está disponível em outros dispositivos, como HoloLens, Xbox e outros dispositivos que executam o Windows 10x.

Ao escrever um código direcionado a dispositivos Windows 10 desktop e não desktop, encapsule a chamada à API em IsApiSetImplemented. Essa função testará em runtime se o conjunto de APIs ao qual a API pertence estiver presente na plataforma de destino. Para obter mais detalhes, consulte Detectar disponibilidade do conjunto de API.

Para identificar se uma determinada API Win32 pertence a um conjunto de API, examine a tabela de requisitos na documentação de referência da API. Se a API pertencer a um conjunto de API, a tabela de requisitos no artigo listará o nome do conjunto de APIs.