Fonction MappingGetServices (elscore.h)

Article
03/02/2024

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