Enumerar y liberar servicios

La aplicación ELS llama a la función MappingGetServices para determinar los servicios que están disponibles en el sistema operativo. La función se puede usar para enumerar todos los servicios ELS disponibles o para filtrar los servicios en función de los criterios de búsqueda proporcionados por la aplicación. Cuando ya no se necesitan servicios, la aplicación llama a MappingFreeServices.

Obtener todos los servicios admitidos

En este ejemplo de código se muestra el uso de MappingGetServices y MappingFreeServices para enumerar y, a continuación, liberar todos los servicios disponibles en el sistema operativo. Para ello, la aplicación pasa NULL para el parámetro pOptions de MappingGetServices.

#include <windows.h>
#include <stdio.h>
#include <elscore.h>

int __cdecl main()
{
    PMAPPING_SERVICE_INFO   prgServices = NULL;
    DWORD                   dwServicesCount = 0;
    HRESULT                 Result;
    DWORD                   i;

    // Get all installed ELS services.
    Result = MappingGetServices(NULL, &prgServices, &dwServicesCount);

    if (SUCCEEDED(Result))
    {
        for (i = 0; i < dwServicesCount; ++i)
        {
            // Do something with each service.
            // ... prgServices[i] ...
            printf_s("Service: %ws, category: %ws\n",
                prgServices[i].pszDescription, prgServices[i].pszCategory);
        }
        MappingFreeServices(prgServices);
    }
    return 0;
}

Obtener servicios específicos

En el ejemplo siguiente se muestra el uso de MappingGetServices y MappingFreeServices para enumerar y, a continuación, liberar todos los servicios de la categoría "Detección de idioma". Para obtener más información sobre esta categoría de servicio, vea Detección de idioma de Microsoft.

#include <windows.h>
#include <stdio.h>
#include <elscore.h>

int __cdecl main()
{
    MAPPING_ENUM_OPTIONS    EnumOptions;
    PMAPPING_SERVICE_INFO   prgServices = NULL;
    DWORD                   dwServicesCount = 0;
    HRESULT                 Result;
    DWORD                   i;

    ZeroMemory(&EnumOptions, sizeof (MAPPING_ENUM_OPTIONS));
    EnumOptions.Size = sizeof (MAPPING_ENUM_OPTIONS);

    // Use the Language Auto-Detection category to enumerate
    // all language detection services.
    EnumOptions.pszCategory = L"Language Detection";

    // Execute the enumeration:
    Result = MappingGetServices(&EnumOptions, &prgServices, &dwServicesCount);

    if (SUCCEEDED(Result))
    {
        for (i = 0; i < dwServicesCount; ++i)
        {
            // Do something with each service.
            // ... prgServices[i] ...
            printf_s("Service: %ws, category: %ws\n",
                prgServices[i].pszDescription, prgServices[i].pszCategory);
        }
        MappingFreeServices(prgServices);
    }
    return 0;
}

Temas relacionados

Uso de servicios lingüísticos extendidos

MappingFreeServices

MappingGetServices