MappingGetServices-Funktion (elscore.h)

Artikel
02/26/2024

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.

Hinweis Die Anwendung muss auf Fehler testen, bevor sie mit weiteren Vorgängen fortfahren kann.

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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	elscore.h
Bibliothek	Elscore.lib
DLL	Elscore.dll