MappingGetServices-Funktion (elscore.h)

Ruft eine Liste der verfügbaren von der ELS-Plattform unterstützten Dienste zusammen mit den zugehörigen Informationen gemäß den anwendungsspezifischen Kriterien ab.

Syntax

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

Parameter

[in, optional] pOptions

Zeiger auf eine MAPPING_ENUM_OPTIONS-Struktur , die Kriterien enthält, die während der Enumeration von Diensten verwendet werden sollen. Die Anwendung gibt NULL für diesen Parameter an, um alle installierten Dienste abzurufen.

[out] prgServices

Adresse eines Zeigers auf ein Array von MAPPING_SERVICE_INFO Strukturen, die Dienstinformationen enthalten, die den im pOptions-Parameter angegebenen Kriterien entsprechen.

[out] pdwServicesCount

Zeiger auf eine DWORD-Variable, in der diese Funktion die Anzahl der abgerufenen Dienste abruft.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Die Funktion gibt einen HRESULT-Fehlerwert zurück, wenn sie nicht erfolgreich ist.

Hinweise

Die ELS-Anwendung kann entweder alle Dienste abrufen oder die Dienste nach den angegebenen Optionen filtern. Eine zugeordnete Prozedur und ein Codebeispiel finden Sie unter Enumerating and Freeing Services( Enumerating and Freeing Services).

Um Ressourcenverluste zu vermeiden, muss die Anwendung den von prgServices angegebenen Zeiger mit einem Aufruf von MappingFreeServices freigeben.

Aus Leistungsgründen wird empfohlen, Dienste nur selten abzurufen. Wenn die Anwendung z. B. einen bestimmten Dienst benötigt, kann er nach Bedarf nach GUID aufgezählt und für die zukünftige Verwendung zwischengespeichert werden.

Anforderungen

Weitere Informationen

Aufzählen und Freigeben von Diensten

Erweiterte linguistische Dienste

Erweiterte Sprachdienstfunktionen

MAPPING_ENUM_OPTIONS

MAPPING_SERVICE_INFO

MappingFreeServices