Función MappingGetServices (elscore.h)

Artículo
08/23/2023

Recupera una lista de los servicios compatibles con la plataforma ELS disponibles, junto con la información asociada, según los criterios especificados por la aplicación.

Sintaxis

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

Parámetros

[in, optional] pOptions

Puntero a una estructura de MAPPING_ENUM_OPTIONS que contiene criterios que se usarán durante la enumeración de servicios. La aplicación especifica NULL para este parámetro para recuperar todos los servicios instalados.

[out] prgServices

Dirección de un puntero a una matriz de estructuras de MAPPING_SERVICE_INFO que contienen información de servicio que coincide con los criterios proporcionados en el parámetro pOptions .

[out] pdwServicesCount

Puntero a una variable DWORD en la que esta función recupera el número de servicios recuperados.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente. La función devuelve un valor HRESULT de error si no se realiza correctamente.

Nota La aplicación debe probar cualquier error antes de continuar con otras operaciones.

Comentarios

La aplicación ELS puede recuperar todos los servicios o filtrar los servicios según las opciones especificadas. Para obtener un procedimiento asociado y un ejemplo de código, consulte Enumeración y freeing Services.

Para evitar pérdidas de recursos, la aplicación debe liberar el puntero indicado por prgServices con una llamada a MappingFreeServices.

Por motivos de rendimiento, se recomienda recuperar servicios con poca frecuencia. Por ejemplo, si la aplicación necesita un servicio específico, por GUID, se puede enumerar cuando sea necesario y almacenarse en caché para su uso futuro.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2 [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	elscore.h
Library	Elscore.lib
Archivo DLL	Elscore.dll