1 /*

     2 * Copyright (c) 2005-2006 Nokia Corporation and/or its subsidiary(-ies). 

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  MnProviderFinder class

    15 *

    16 */

    17 

    18 

    19 #ifndef MN_PROVIDERFINDER_H

    20 #define MN_PROVIDERFINDER_H

    21 

    22 #include <e32cmn.h>

    23 #include "mnprovider.h"

    24 

    25 /** @brief Provides static methods for discovering

    26  *  Map and Navigation provider applications available in the system.

    27  *

    28  *  @since 3.1

    29  *  @lib mnclientlib.dll

    30  *  @ingroup DiscoveryAPI

    31  */

    32 class MnProviderFinder

    33     {

    34     public :

    35         /** @brief Finds all Map and Navigation Provider Applications

    36          *  in the system.

    37          *

    38          *  @param[out] aProviders Array of provider applications found. This

    39          *                         array is left unchanged, if no providers found.

    40          *                         Client takes ownership of objects in the array.

    41          */

    42         IMPORT_C static void FindProvidersL(

    43             RPointerArray<CMnProvider>& aProviders);

    44 

    45         /** @brief Finds all Map and Navigation Provider Applications

    46          *  in the system, which are capable of specified features.

    47          *

    48          *  @param[out] aProviders Array of provider applications found. This

    49          *                         array is left unchanged, if no providers found.

    50          *                         Client takes ownership of objects in the array.

    51          *  @param aRequiredServices Bitmap of map and navigation features. Only

    52          *                           those providers, which support all these

    53          *                           services are listed on return.

    54          */

    55         IMPORT_C static void FindProvidersL(

    56             RPointerArray<CMnProvider>& aProviders,

    57             CMnProvider::TServices aRequiredServices);

    58     };

    59 

    60 #endif // MN_PROVIDERFINDER_H

    61