Funzione MappingGetServices (elscore.h)
Recupera un elenco dei servizi supportati dalla piattaforma ELS disponibili, insieme alle informazioni associate, in base ai criteri specificati dall'applicazione.
Sintassi
HRESULT MappingGetServices(
[in, optional] PMAPPING_ENUM_OPTIONS pOptions,
[out] PMAPPING_SERVICE_INFO *prgServices,
[out] DWORD *pdwServicesCount
);
Parametri
[in, optional] pOptions
Puntatore a una struttura MAPPING_ENUM_OPTIONS contenente criteri da usare durante l'enumerazione dei servizi. L'applicazione specifica NULL per questo parametro per recuperare tutti i servizi installati.
[out] prgServices
Indirizzo di un puntatore a una matrice di strutture MAPPING_SERVICE_INFO contenenti informazioni sul servizio corrispondenti ai criteri specificati nel parametro pOptions .
[out] pdwServicesCount
Puntatore a una variabile DWORD in cui questa funzione recupera il numero di servizi recuperati.
Valore restituito
Restituisce S_OK in caso di esito positivo. La funzione restituisce un valore HRESULT di errore se non riesce.
Commenti
L'applicazione ELS può recuperare tutti i servizi o filtrare i servizi in base alle opzioni specificate. Per una procedura associata e un esempio di codice, vedere Enumerazione e freeing services.
Per evitare perdite di risorse, l'applicazione deve liberare il puntatore indicato da prgServices con una chiamata a MappingFreeServices.
Per motivi di prestazioni, è consigliabile recuperare i servizi raramente. Ad esempio, se l'applicazione richiede un servizio specifico, tramite GUID, può essere enumerata quando necessario e memorizzata nella cache per un uso futuro.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 7 [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2008 R2 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | elscore.h |
| Libreria | Elscore.lib |
| DLL | Elscore.dll |
Vedi anche
Enumerazione e freeing dei servizi