Função MappingGetServices (elscore.h)

Artigo
08/23/2023

Recupera uma lista de serviços compatíveis com a plataforma ELS disponíveis, juntamente com informações associadas, de acordo com os critérios especificados pelo aplicativo.

Sintaxe

HRESULT MappingGetServices(
  [in, optional] PMAPPING_ENUM_OPTIONS pOptions,
  [out]          PMAPPING_SERVICE_INFO *prgServices,
  [out]          DWORD                 *pdwServicesCount
);

Parâmetros

[in, optional] pOptions

Ponteiro para uma estrutura MAPPING_ENUM_OPTIONS que contém critérios a serem usados durante a enumeração de serviços. O aplicativo especifica NULL para que esse parâmetro recupere todos os serviços instalados.

[out] prgServices

Endereço de um ponteiro para uma matriz de estruturas de MAPPING_SERVICE_INFO que contêm informações de serviço que correspondem aos critérios fornecidos no parâmetro pOptions .

[out] pdwServicesCount

Ponteiro para uma variável DWORD na qual essa função recupera o número de serviços recuperados.

Retornar valor

Retorna S_OK se tiver êxito. A função retornará um valor HRESULT de erro se não for bem-sucedida.

Nota O aplicativo deve testar qualquer falha antes de prosseguir com outras operações.

Comentários

O aplicativo ELS pode recuperar todos os serviços ou filtrar os serviços de acordo com as opções especificadas. Para obter um procedimento associado e um exemplo de código, consulte Enumerando e liberando serviços.

Para evitar vazamentos de recursos, o aplicativo deve liberar o ponteiro indicado por prgServices com uma chamada para MappingFreeServices.

Por motivos de desempenho, é recomendável recuperar serviços com pouca frequência. Por exemplo, se o aplicativo precisar de um serviço específico, por GUID, ele poderá ser enumerado quando necessário e armazenado em cache para uso futuro.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	elscore.h
Biblioteca	Elscore.lib
DLL	Elscore.dll