| class MNcdPurchaseDetails |
Purchase details.
| Public Member Functions | |
|---|---|
| ~MNcdPurchaseDetails() | |
| TInt32 | AttributeInt32(TPurchaseAttribute) |
| const TDesC & | AttributeString(TPurchaseAttribute) |
| const TDesC & | CatalogSourceName() |
| TUid | ClientUid() |
| const TDesC & | Description() |
| const TDesC & | DownloadAccessPoint() |
| TArray< MNcdPurchaseDownloadInfo * > | DownloadInfoL() |
| const MDesCArray & | DownloadedFiles() |
| const TDesC & | EntityId() |
| const TDesC & | FinalPrice() |
| TBool | HasIcon() |
| const TDesC8 & | Icon() |
| TArray< MNcdPurchaseInstallInfo * > | InstallInfoL() |
| const TDesC & | ItemName() |
| TUint | ItemPurpose() |
| TItemType | ItemType() |
| TInt | LastOperationErrorCode() |
| TTime | LastOperationTime() |
| const TDesC & | Namespace() |
| const TDesC & | OriginNodeId() |
| const TDesC & | PaymentMethodName() |
| const TDesC & | PurchaseOptionId() |
| const TDesC & | PurchaseOptionName() |
| const TDesC & | PurchaseOptionPrice() |
| TTime | PurchaseTime() |
| const TDesC & | ServerUri() |
| TState | State() |
| TInt | TotalContentSize() |
| const TDesC & | Version() |
| Public Member Enumerations | |
|---|---|
| enum | TItemType { EUnknown = 0, EItem = 1, EFolder = 2 } |
| enum | TPurchaseAttribute { EPurchaseAttributeContentUid = 0, EPurchaseAttributeContentMimeType, EPurchaseAttributeInternal } |
| enum | TState { EStatePurchased, EStateDownloaded, EStateInstalled } |
| TInt32 | AttributeInt32 | ( | TPurchaseAttribute | aAttribute | ) | const [pure virtual] |
Integer attribute getter
| TPurchaseAttribute aAttribute | Attribute |
| const TDesC & | AttributeString | ( | TPurchaseAttribute | aAttribute | ) | const [pure virtual] |
String attribute getter
| TPurchaseAttribute aAttribute | Attribute |
| const TDesC & | DownloadAccessPoint | ( | ) | const [pure virtual] |
Get access point used in download process.
| TArray< MNcdPurchaseDownloadInfo * > | DownloadInfoL | ( | ) | const [pure virtual] |
Get download infos.
Only valid for purchases in EStatePurchased state.
| const MDesCArray & | DownloadedFiles | ( | ) | const [pure virtual] |
Get file name(s) of the downloaded file(s).
Only valid for purchases in EStateDownloaded state.
| TBool | HasIcon | ( | ) | const [pure virtual] |
Checks whether this purchase detail has an icon.
This flag's intention is to indicate whether this purchase detail has an icon saved in the purhcase history. This does not indicate whether the actual icon data has been loaded or not.
| TArray< MNcdPurchaseInstallInfo * > | InstallInfoL | ( | ) | const [pure virtual] |
Get file installation infos.
Only valid for purchases in EStateInstalled state.
| TInt | LastOperationErrorCode | ( | ) | const [pure virtual] |
Getter for the last operation error code that has been set by the NCD Engine during operations or by the user of the API.
The state gives the current state of the purchase details. If the error code is KErrNone, then the state of the purchase detail describes the state after a successfull operation. If the error code differs from KErrNone, then an error has occurred during an operation. The error code and the state can be used together to conclude what kind of operation failed. If the state is EStatePurchased after an error occurred, then there are two possibilities: either a purchase operation has failed or a download operation has failed. If the state is EStateDownloaded after an error occurred, then install operation has failed. If the state is EStateInstalled, then installing has succesfully completed and the error code should be KErrNone. If EStateInstalled is given with some other error code, this means that the installation was success but some repository information could not be set correctly.
| TTime | LastOperationTime | ( | ) | const [pure virtual] |
Getter for the time of last operation that has been directed to the purchase item. The time is an universal time.
| const TDesC & | PurchaseOptionName | ( | ) | const [pure virtual] |
Get purchase option name.
| const TDesC & | PurchaseOptionPrice | ( | ) | const [pure virtual] |
Get purchase option price.
| TTime | PurchaseTime | ( | ) | const [pure virtual] |
Get time of purchase. The time is universal time, not local time.
| TState | State | ( | ) | const [pure virtual] |
Get purchase state.
When an item has been installed, its state will remain as EStateInstalled in the purhcase detail even if the content was uninstalled.
| TInt | TotalContentSize | ( | ) | const [pure virtual] |
Get the total size of the content of the item.
Type of the purchased item.
| EUnknown = 0 |
Item has unknown type. |
| EItem = 1 |
This is item. |
| EFolder = 2 |
This is folder. |
Additional attributes
These are retrieved with AttributeString and AttributeInt32
Adding new attributes does not cause a binary break but removing does
| EPurchaseAttributeContentUid = 0 |
Content UID received in a protocol response Type: Int32 |
| EPurchaseAttributeContentMimeType |
Content MIME type received in a protocol response Type: String |
| EPurchaseAttributeInternal |
Internal attribute value, DO NOT USE Note:
Add new attributes before this |
State of the purchase.
| EStatePurchased |
Payment made, but not downloaded nor installed. |
| EStateDownloaded |
Payment made and content downloaded, but not installed. |
| EStateInstalled |
Payment made, content downloaded and installed. |
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.