Compartilhar via


Função IsApiSetImplemented (apiquery2.h)

Testa se um conjunto de API especificado está presente no computador.

Sintaxe

APICONTRACT BOOL IsApiSetImplemented(
  PCSTR Contract
);

Parâmetros

Contract

Especifica o nome da API definida para consulta. Para obter mais informações, consulte a seção Comentários.

Valor de retorno

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

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

Observações

Todas as versões do Windows 10 compartilham uma base comum de componentes do sistema operacional que é chamada de so 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 da área de trabalho e não desktop, encapsule a chamada à API em IsApiSetImplemented. Essa função testará em runtime se o conjunto de API 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 API.

Requirements

Requirement Value
da Plataforma de Destino Windows
Header apiquery2.h
Library onecore.lib
de DLL api-ms-win-core-apiquery-l2-1-0.dll

Consulte também

Conjuntos de API do Windows

Detectar disponibilidade do conjunto de API

Compilando para o OneCore

Validando drivers Universais do Windows