Partager via


Fonction MappingGetServices (elscore.h)

Récupère une liste des services pris en charge par la plateforme ELS disponibles, ainsi que les informations associées, en fonction des critères spécifiés par l’application.

Syntaxe

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

Paramètres

[in, optional] pOptions

Pointeur vers une structure MAPPING_ENUM_OPTIONS contenant des critères à utiliser lors de l’énumération des services. L’application spécifie NULL pour que ce paramètre récupère tous les services installés.

[out] prgServices

Adresse d’un pointeur vers un tableau de structures MAPPING_SERVICE_INFO contenant des informations de service correspondant aux critères fournis dans le paramètre pOptions .

[out] pdwServicesCount

Pointeur vers une variable DWORD dans laquelle cette fonction récupère le nombre de services récupérés.

Valeur retournée

Retourne S_OK en cas de réussite. La fonction retourne une valeur HRESULT d’erreur si elle ne réussit pas.

Note L’application doit tester tout échec avant de procéder à d’autres opérations.

 

Remarques

L’application ELS peut récupérer tous les services ou filtrer les services en fonction des options spécifiées. Pour obtenir une procédure associée et un exemple de code, consultez Énumération et libération des services.

Pour éviter les fuites de ressources, l’application doit libérer le pointeur indiqué par prgServices avec un appel à MappingFreeServices.

Pour des raisons de performances, il est recommandé de récupérer les services rarement. Par exemple, si l’application a besoin d’un service spécifique, par GUID, il peut être énuméré si nécessaire et mis en cache pour une utilisation ultérieure.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête elscore.h
Bibliothèque Elscore.lib
DLL Elscore.dll

Voir aussi

Énumération et libération des services

Services linguistiques étendus

Fonctions des services linguistiques étendus

MAPPING_ENUM_OPTIONS

MAPPING_SERVICE_INFO

MappingFreeServices