contentstorage/srvinc/cainstallnotifier.h
author hgs
Mon, 20 Sep 2010 10:22:22 +0300
changeset 119 50e220be30d1
parent 92 782e3408c2ab
permissions -rw-r--r--
201037
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
85
7feec50967db 201003_02
hgs
parents:
diff changeset
     1
/*
7feec50967db 201003_02
hgs
parents:
diff changeset
     2
 * Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).
7feec50967db 201003_02
hgs
parents:
diff changeset
     3
 * All rights reserved.
7feec50967db 201003_02
hgs
parents:
diff changeset
     4
 * This component and the accompanying materials are made available
7feec50967db 201003_02
hgs
parents:
diff changeset
     5
 * under the terms of "Eclipse Public License v1.0"
7feec50967db 201003_02
hgs
parents:
diff changeset
     6
 * which accompanies this distribution, and is available
7feec50967db 201003_02
hgs
parents:
diff changeset
     7
 * at the URL "http://www.eclipse.org/legal/epl-v10.html".
7feec50967db 201003_02
hgs
parents:
diff changeset
     8
 *
7feec50967db 201003_02
hgs
parents:
diff changeset
     9
 * Initial Contributors:
7feec50967db 201003_02
hgs
parents:
diff changeset
    10
 * Nokia Corporation - initial contribution.
7feec50967db 201003_02
hgs
parents:
diff changeset
    11
 *
7feec50967db 201003_02
hgs
parents:
diff changeset
    12
 * Contributors:
7feec50967db 201003_02
hgs
parents:
diff changeset
    13
 *
7feec50967db 201003_02
hgs
parents:
diff changeset
    14
 * Description:  ?Description
7feec50967db 201003_02
hgs
parents:
diff changeset
    15
 *
7feec50967db 201003_02
hgs
parents:
diff changeset
    16
 */
7feec50967db 201003_02
hgs
parents:
diff changeset
    17
7feec50967db 201003_02
hgs
parents:
diff changeset
    18
#ifndef CAINSTALLNOTIFIER_H
7feec50967db 201003_02
hgs
parents:
diff changeset
    19
#define CAINSTALLNOTIFIER_H
7feec50967db 201003_02
hgs
parents:
diff changeset
    20
7feec50967db 201003_02
hgs
parents:
diff changeset
    21
#include <e32base.h>
119
hgs
parents: 92
diff changeset
    22
#include <usif/sif/sifnotification.h>
92
hgs
parents: 89
diff changeset
    23
85
7feec50967db 201003_02
hgs
parents:
diff changeset
    24
/**
7feec50967db 201003_02
hgs
parents:
diff changeset
    25
 * Interface for updating after installer events.
7feec50967db 201003_02
hgs
parents:
diff changeset
    26
 *
7feec50967db 201003_02
hgs
parents:
diff changeset
    27
 * @since S60 v5.0
7feec50967db 201003_02
hgs
parents:
diff changeset
    28
 */
7feec50967db 201003_02
hgs
parents:
diff changeset
    29
class MCaInstallListener
7feec50967db 201003_02
hgs
parents:
diff changeset
    30
    {
7feec50967db 201003_02
hgs
parents:
diff changeset
    31
7feec50967db 201003_02
hgs
parents:
diff changeset
    32
public:
7feec50967db 201003_02
hgs
parents:
diff changeset
    33
7feec50967db 201003_02
hgs
parents:
diff changeset
    34
    /**
7feec50967db 201003_02
hgs
parents:
diff changeset
    35
     * Pure virtual method.
7feec50967db 201003_02
hgs
parents:
diff changeset
    36
     * @param aEvent event type.
7feec50967db 201003_02
hgs
parents:
diff changeset
    37
     */
119
hgs
parents: 92
diff changeset
    38
    virtual void HandleInstallNotifyL() = 0;
85
7feec50967db 201003_02
hgs
parents:
diff changeset
    39
    };
7feec50967db 201003_02
hgs
parents:
diff changeset
    40
7feec50967db 201003_02
hgs
parents:
diff changeset
    41
/**
7feec50967db 201003_02
hgs
parents:
diff changeset
    42
 *  CA Install notifier.
7feec50967db 201003_02
hgs
parents:
diff changeset
    43
 *
7feec50967db 201003_02
hgs
parents:
diff changeset
    44
 *  @since S60 v5.0
7feec50967db 201003_02
hgs
parents:
diff changeset
    45
 */
119
hgs
parents: 92
diff changeset
    46
NONSHARABLE_CLASS( CCaInstallNotifier ) : public CBase,
hgs
parents: 92
diff changeset
    47
        public Usif::MSifOperationsHandler
85
7feec50967db 201003_02
hgs
parents:
diff changeset
    48
    {
7feec50967db 201003_02
hgs
parents:
diff changeset
    49
7feec50967db 201003_02
hgs
parents:
diff changeset
    50
public:
7feec50967db 201003_02
hgs
parents:
diff changeset
    51
7feec50967db 201003_02
hgs
parents:
diff changeset
    52
    /**
7feec50967db 201003_02
hgs
parents:
diff changeset
    53
     * Enum defining notification type.
7feec50967db 201003_02
hgs
parents:
diff changeset
    54
     */
7feec50967db 201003_02
hgs
parents:
diff changeset
    55
    enum TNotificationType
7feec50967db 201003_02
hgs
parents:
diff changeset
    56
        {
92
hgs
parents: 89
diff changeset
    57
        ENoNotification,            ///< No notification.
hgs
parents: 89
diff changeset
    58
        ESisInstallNotification,    ///< System installation notification.
119
hgs
parents: 92
diff changeset
    59
        EAllTypesNotification,    ///< System installation notification.
85
7feec50967db 201003_02
hgs
parents:
diff changeset
    60
        };
7feec50967db 201003_02
hgs
parents:
diff changeset
    61
7feec50967db 201003_02
hgs
parents:
diff changeset
    62
    /**
92
hgs
parents: 89
diff changeset
    63
     * Creates an instance of CCaInstallNotifier.
85
7feec50967db 201003_02
hgs
parents:
diff changeset
    64
     * @param aNotifier Reference to notifier interface.
7feec50967db 201003_02
hgs
parents:
diff changeset
    65
     * @param aNotificationType Notification type.
7feec50967db 201003_02
hgs
parents:
diff changeset
    66
     */
89
hgs
parents: 85
diff changeset
    67
IMPORT_C static CCaInstallNotifier* NewL( MCaInstallListener& aListener,
119
hgs
parents: 92
diff changeset
    68
            TNotificationType aNotificationType = EAllTypesNotification );
hgs
parents: 92
diff changeset
    69
hgs
parents: 92
diff changeset
    70
    /**
hgs
parents: 92
diff changeset
    71
     * Called when a new operation is started. The client should use the S
hgs
parents: 92
diff changeset
    72
     * ubscribeL() method (@see CSifOperationsNotifier) to register for progress
hgs
parents: 92
diff changeset
    73
     * and end notification for this operation. This function should return
hgs
parents: 92
diff changeset
    74
     * quickly as this is run as part of an active object request completion
hgs
parents: 92
diff changeset
    75
     * handler.
hgs
parents: 92
diff changeset
    76
hgs
parents: 92
diff changeset
    77
     * @param aKey The Start End key of the operation.
hgs
parents: 92
diff changeset
    78
     * @param aStartData Start operation related information.
hgs
parents: 92
diff changeset
    79
     */
hgs
parents: 92
diff changeset
    80
    void StartOperationHandler(
hgs
parents: 92
diff changeset
    81
            TUint aKey, const Usif::CSifOperationStartData& aStartData);
hgs
parents: 92
diff changeset
    82
hgs
parents: 92
diff changeset
    83
    /**
hgs
parents: 92
diff changeset
    84
     * Called when an operation completes.
hgs
parents: 92
diff changeset
    85
     * This function should return quickly as this is run as part of an active
hgs
parents: 92
diff changeset
    86
     * object request completion handler.
hgs
parents: 92
diff changeset
    87
hgs
parents: 92
diff changeset
    88
     * @param aEndData End operation related information.
hgs
parents: 92
diff changeset
    89
     */
hgs
parents: 92
diff changeset
    90
    void EndOperationHandler(const Usif::CSifOperationEndData& aEndData);
hgs
parents: 92
diff changeset
    91
hgs
parents: 92
diff changeset
    92
    /**
hgs
parents: 92
diff changeset
    93
     * Called whenever a progress update is available.
hgs
parents: 92
diff changeset
    94
     * This function should return quickly as this is run as part of an active
hgs
parents: 92
diff changeset
    95
     * object request completion handler.
hgs
parents: 92
diff changeset
    96
hgs
parents: 92
diff changeset
    97
     * @param aProgressData Progress operation related information.
hgs
parents: 92
diff changeset
    98
     */
hgs
parents: 92
diff changeset
    99
    void ProgressOperationHandler(
hgs
parents: 92
diff changeset
   100
            const Usif::CSifOperationProgressData& aProgressData);
85
7feec50967db 201003_02
hgs
parents:
diff changeset
   101
7feec50967db 201003_02
hgs
parents:
diff changeset
   102
    /**
7feec50967db 201003_02
hgs
parents:
diff changeset
   103
     * Destructor.
7feec50967db 201003_02
hgs
parents:
diff changeset
   104
     */
7feec50967db 201003_02
hgs
parents:
diff changeset
   105
    virtual ~CCaInstallNotifier();
7feec50967db 201003_02
hgs
parents:
diff changeset
   106
7feec50967db 201003_02
hgs
parents:
diff changeset
   107
private:
7feec50967db 201003_02
hgs
parents:
diff changeset
   108
7feec50967db 201003_02
hgs
parents:
diff changeset
   109
    /**
7feec50967db 201003_02
hgs
parents:
diff changeset
   110
     * Constructor.
7feec50967db 201003_02
hgs
parents:
diff changeset
   111
     * @param aNotifier Reference to notifier interface.
7feec50967db 201003_02
hgs
parents:
diff changeset
   112
     */
92
hgs
parents: 89
diff changeset
   113
    CCaInstallNotifier( MCaInstallListener& aListener );
85
7feec50967db 201003_02
hgs
parents:
diff changeset
   114
7feec50967db 201003_02
hgs
parents:
diff changeset
   115
    /**
7feec50967db 201003_02
hgs
parents:
diff changeset
   116
     * Symbian 2nd phase constructor.
7feec50967db 201003_02
hgs
parents:
diff changeset
   117
     * @param aNotificationType Notification type.
7feec50967db 201003_02
hgs
parents:
diff changeset
   118
     */
92
hgs
parents: 89
diff changeset
   119
    void ConstructL( TNotificationType aNotificationType );
85
7feec50967db 201003_02
hgs
parents:
diff changeset
   120
7feec50967db 201003_02
hgs
parents:
diff changeset
   121
private:
7feec50967db 201003_02
hgs
parents:
diff changeset
   122
7feec50967db 201003_02
hgs
parents:
diff changeset
   123
    /**
7feec50967db 201003_02
hgs
parents:
diff changeset
   124
     * Interface for notifying changes in folder.
7feec50967db 201003_02
hgs
parents:
diff changeset
   125
     * Not Own.
7feec50967db 201003_02
hgs
parents:
diff changeset
   126
     */
7feec50967db 201003_02
hgs
parents:
diff changeset
   127
    MCaInstallListener& iListener;
7feec50967db 201003_02
hgs
parents:
diff changeset
   128
119
hgs
parents: 92
diff changeset
   129
    /**
hgs
parents: 92
diff changeset
   130
     * USIF notifier
hgs
parents: 92
diff changeset
   131
     * Own.
85
7feec50967db 201003_02
hgs
parents:
diff changeset
   132
     */
119
hgs
parents: 92
diff changeset
   133
    Usif::CSifOperationsNotifier* iNotifier;
hgs
parents: 92
diff changeset
   134
hgs
parents: 92
diff changeset
   135
    TUint iKey;
hgs
parents: 92
diff changeset
   136
hgs
parents: 92
diff changeset
   137
    TNotificationType iNotificationType;
85
7feec50967db 201003_02
hgs
parents:
diff changeset
   138
7feec50967db 201003_02
hgs
parents:
diff changeset
   139
    };
7feec50967db 201003_02
hgs
parents:
diff changeset
   140
7feec50967db 201003_02
hgs
parents:
diff changeset
   141
#endif /* CAINSTALLNOTIFIER_H */
7feec50967db 201003_02
hgs
parents:
diff changeset
   142
7feec50967db 201003_02
hgs
parents:
diff changeset
   143
// End of File
7feec50967db 201003_02
hgs
parents:
diff changeset
   144