include/alp/contacts_dml.h

Go to the documentation of this file.
00001 /******************************************************************************
00002  * Copyright (c) 1999-2008 ACCESS CO., LTD. All rights reserved.
00003  * Copyright (c) 2006 PalmSource, Inc (an ACCESS company).  All rights reserved.
00004  ******************************************************************************/
00017 #ifndef ALP_CONTACTS_DML_H_DEFINED
00018 #define ALP_CONTACTS_DML_H_DEFINED
00019 
00020 #include <stdint.h>
00021 #include <stdbool.h>
00022 #include <string.h>
00023 #include <alp/catmgr_dml.h>
00024 #include <alp/hs_change_mgr.h>
00025 #include <alp/sysclass.h>
00026 #include <alp/types.h>
00027 #include <glib.h>
00028 
00038 #define kContactIdentifierPrefix        "Contact"
00039 #define kContactIdentifier1         "Contact1"
00040 #define kContactIdentifier2         "Contact2"
00041 #define kContactIdentifier3         "Contact3"
00042 #define kContactIdentifier4         "Contact4"
00043 #define kContactIdentifier5         "Contact5"
00044 #define kContactIdentifier6         "Contact6"
00045 #define kContactIdentifierURL       "ContactURL"
00046 #define kContactIMIdentifierPrefix      "ContactIM"
00047 #define kContactIdentifierIM1           kContactIMIdentifierPrefix "1"
00048 #define kContactIdentifierIM2           kContactIMIdentifierPrefix "2"
00049 
00054 #define kContactTypeHome        "Home"
00055 #define kContactTypeWork        "Work"
00056 #define kContactTypeMobile      "Mobile"
00057 #define kContactTypeEmail       "Email"
00058 #define kContactTypeFAX         "FAX"
00059 #define kContactTypeVideo       "Video"
00060 #define kContactTypeOther       "Other"
00061 
00065 #define kContactTypeYahooIM     "YahooIM"
00066 #define kContactTypeAIM         "AIM"
00067 #define kContactTypeMSNIM       "MSNIM"
00068 #define kContactTypeJabberIM    "JabberIM"
00069 #define kContactTypeICQ         "ICQ"
00070 
00073 #define kContactTypeURL         "URL"
00074 
00078 #define kAddressTypeHome        "Home"
00079 #define kAddressTypeWork        "Work"
00080 #define kAddressTypeOther       "Other"
00081 
00086 #define kAddressLabelTypeHome   "LabelHome"
00087 #define kAddressLabelTypeWork   "LabelWork"
00088 #define kAddressLabelTypeOther  "LabelOther"
00089 
00091 #define kCustomLabelIdentifierPrefix "Custom"
00092 #define kCustomLabelIdentifier1   kCustomLabelIdentifierPrefix "1"
00093 #define kCustomLabelIdentifier2   kCustomLabelIdentifierPrefix "2"
00094 #define kCustomLabelIdentifier3   kCustomLabelIdentifierPrefix "3"
00095 #define kCustomLabelIdentifier4   kCustomLabelIdentifierPrefix "4"
00096 #define kCustomLabelIdentifier5   kCustomLabelIdentifierPrefix "5"
00097 #define kCustomLabelIdentifier6   kCustomLabelIdentifierPrefix "6"
00098 #define kCustomLabelIdentifier7   kCustomLabelIdentifierPrefix "7"
00099 #define kCustomLabelIdentifier8   kCustomLabelIdentifierPrefix "8"
00100 #define kCustomLabelIdentifier9   kCustomLabelIdentifierPrefix "9"
00101 
00103 #define kDistributionContactTypeEmail           "Email"
00104 #define kDistributionContactTypeMessaging       "Messaging"
00105 
00113 #define ALP_STATUS_CONTACTS_DML_NO_MEM              \
00114         (ALP_CLASS_CONTACTS_DML | 0x00010000)
00115 #define ALP_STATUS_CONTACTS_DML_NO_RECORDS              \
00116         (ALP_CLASS_CONTACTS_DML | 0x00020000)
00117 #define ALP_STATUS_CONTACTS_DML_BAD_PARAM               \
00118         (ALP_CLASS_CONTACTS_DML | 0x00030000)
00119 #define ALP_STATUS_CONTACTS_DML_DATABASE_ERR        \
00120         (ALP_CLASS_CONTACTS_DML | 0x00040000)
00121 #define ALP_STATUS_CONTACTS_DML_INVALID_LUID        \
00122         (ALP_CLASS_CONTACTS_DML | 0x00050000)
00123 #define ALP_STATUS_CONTACTS_DML_INTERNAL_ERR        \
00124         (ALP_CLASS_CONTACTS_DML | 0x00060000)
00125 #define ALP_STATUS_CONTACTS_DML_NO_MATCH            \
00126         (ALP_CLASS_CONTACTS_DML | 0x00070000)
00127 #define ALP_STATUS_CONTACTS_DML_DUPLICATE_ITEM      \
00128     (ALP_CLASS_CONTACTS_DML | 0x00080000)
00129 #define ALP_STATUS_CONTACTS_DML_MISSING_PROPERTY    \
00130     (ALP_CLASS_CONTACTS_DML | 0x00090000)
00131 #define ALP_STATUS_CONTACT_DML_CHANGEMGR_ERROR          \
00132     (ALP_CLASS_CONTACTS_DML | 0x000A0000)
00133 #define ALP_STATUS_CONTACT_DML_NO_CHANGE_TRACKING_ERROR \
00134     (ALP_CLASS_CONTACTS_DML | 0x000B0000)
00135 #define ALP_STATUS_CONTACTS_DML_UNFETCHED_COLUMN    \
00136     (ALP_CLASS_CONTACTS_DML | 0x000C0000)
00137 #define ALP_STATUS_CONTACTS_DML_INVALID_CUSTOM_COLUMN    \
00138     (ALP_CLASS_CONTACTS_DML | 0x000D0000)
00139 #define ALP_STATUS_CONTACTS_DML_INVALID_CUSTOM_SPECIFICATION    \
00140     (ALP_CLASS_CONTACTS_DML | 0x000E0000)
00141 #define ALP_STATUS_CONTACTS_DML_SIM_BUSY                \
00142     (ALP_CLASS_CONTACTS_DML | 0x000F0000)
00143 #define ALP_STATUS_CONTACTS_DML_NO_CAT_RINGTONE         \
00144     (ALP_CLASS_CONTACTS_DML | 0x00100000)
00145 #define ALP_STATUS_CONTACT_DML_CHANGEMGR_CONFLICT       \
00146     (ALP_CLASS_CONTACTS_DML | 0x00200000)
00147 #define ALP_STATUS_CONTACT_DML_DATABASE_BUSY            \
00148     (ALP_CLASS_CONTACTS_DML | 0x00300000)
00149 #define ALP_STATUS_CONTACTS_DML_INVALID_TYPE    \
00150     (ALP_CLASS_CONTACTS_DML | 0x00400000)
00151 #define ALP_STATUS_CONTACTS_DML_DRM_FILE    \
00152     (ALP_CLASS_CONTACTS_DML | 0x00500000)
00153 #define ALP_STATUS_CONTACTS_DML_CONTACTS_FULL    \
00154     (ALP_CLASS_CONTACTS_DML | 0x00600000)
00155 #define ALP_STATUS_CONTACTS_DML_UNSUPPORTED_PROPERTY    \
00156     (ALP_CLASS_CONTACTS_DML | 0x00700000)
00157 
00168 #define ALP_CONTACTS_DML_GET_MONTH(x) \
00169         (((((uint32_t) x) >> 5 ) & 0xF) - 1)
00170 #define ALP_CONTACTS_DML_SET_MONTH( x, month ) \
00171         (x = ((((uint32_t) x) & 0xFFFFFE1F) | (( (month+1) & 0xF ) << 5 )))
00172 
00173 #define ALP_CONTACTS_DML_GET_DAY(x) \
00174         ( x & 0x1F )
00175 #define ALP_CONTACTS_DML_SET_DAY( x, day ) \
00176         (x = ((((uint32_t) x) & 0xFFFFFFE0) | ( day & 0x1F )))
00177 
00178 #define ALP_CONTACTS_DML_GET_YEAR(x) \
00179         ((((uint32_t) x) >> 9 ) & 0x007FFFFF)
00180 #define ALP_CONTACTS_DML_SET_YEAR( x, year) \
00181         (x = ((((uint32_t) x) & 0x000001FF) | (( year & 0x7FFFFF) << 9 )))
00182 
00188 #ifndef WIN32
00189 #define ALP_DATAMODEL_NOTIFICATION_TYPE_CONTACTS        "alp/datamodel/contacts"
00190 #else
00191 #define ALP_DATAMODEL_NOTIFICATION_TYPE_CONTACTS        _T("alp/datamodel/contacts")
00192 #endif
00193 
00196 #define kContactLocalURI                                "./alp/PIM/Contacts/Content"
00197 #define kContactTargetURI                               "./alp/PIM/Contacts/Content"
00198 #define kContactCategoryLocalURI                "./alp/PIM/Contacts/Category"
00199 #define kContactCategoryTargetURI               "./alp/PIM/Contacts/Category"
00200 #define kContactCatMembershipLocalURI   "./alp/PIM/Contacts/Membership"
00201 #define kContactCatMembershipTargetURI  "./alp/PIM/Contacts/Membership"
00202 #define kContactCustomLabelsLocalURI    "./alp/PIM/Contacts/CustomLabels"
00203 #define kContactCustomLabelsTargetURI   "./alp/PIM/Contacts/CustomLabels"
00204 
00212 typedef enum {
00213         PersonItem                                      = 1,
00214         ContactItem                                     = 2,
00215         AddressItem                                     = 3,
00216         ExtraFieldItem                          = 4,
00217         ThumbnailItem                           = 5,
00218         CustomLabelItem                         = 6,
00219         DistributionItem                        = 7,
00220         ListViewItem                            = 8,    
00221         DistributionMembershipItem      = 9             
00222 } AlpContactsDmlItemType;
00223 
00227 typedef enum {
00228         Prefix                  = 1,    
00229         Suffix                  = 2,    
00230         FirstName               = 3,    
00231         LastName                = 4,    
00232         MiddleName              = 5,    
00233         Title                   = 6,    
00234         SmallThumbnail  = 7,    
00235         Company                 = 8,    
00236         NickName                = 9,    
00237         ThumbnailFileName = 10, 
00238         YomiFirstName   = 11,   
00239         YomiLastName    = 12,   
00240         YomiCompany             = 13,   
00241         Ringtone                = 14,   
00242         Note                    = 15,   
00243         Birthday        = 16,   
00244         BirthdayAlarm   = 17,   
00245         Anniversary     = 18,   
00246         AnniversaryAlarm= 19,   
00247         EnglishName     = 20,   
00248         UseCount                = 21,   
00249         DontBeamNote    = 22,   
00250         IsBusinessCard  = 23,   
00251 
00252         Identifier              = 24,   
00253         Address                 = 25,   
00254         City                    = 26,   
00255         State                   = 27,   
00256         PostalCode              = 28,   
00257         Country                 = 29,   
00258         VCardSrc                = 30,   
00259         LargeThumbnail  = 31,   
00260         Value                   = 32,   
00261 
00262         ContactType             = 34,   
00263         SpeedDial               = 35,   
00264         DefaultContact  = 36,   
00265         ThumbnailData   = 37,   
00266         Label           = 38,   
00267         
00268         SIMPhoneBook    = 39,   
00269         SIMEntryID              = 40,   
00270         ContactID               = 41,   
00271         VideoRingtone   = 42,   
00272         kContactsDMLLastPublicColumn = VideoRingtone,
00273         kContactsDMLReservedColumn      = -1    // Reserved for internal use
00274 } AlpContactsDmlColumnType;
00275 
00277 typedef enum {
00278         OrderByNone,
00279         OrderByLastFirstCompany,
00280         OrderByLastCompanyFirst,
00281         OrderByFirstLastCompany,
00282         OrderByFirstCompanyLast,
00283         OrderByCompanyFirstLast,
00284         OrderByCompanyLastFirst,
00285         NumOrderByTypes
00286 } AlpContactsDmlOrderByType;
00287 
00289 typedef enum {
00290         OrderDistributionByID,
00291         OrderDistributionByValue,
00292         OrderDistributionByType,
00293         NumDistributionOrderByTypes
00294 } AlpContactsDmlDistributionOrderByType;
00295 
00297 typedef enum {
00298         OrderDistributionMembershipByNone,
00299         OrderDistributionMembershipByDistributionID,
00300         NumDistributionMembershipOrderByTypes
00301 } AlpContactsDmlDistributionMembershipOrderByType;
00302 
00304 typedef enum {
00305         FriendlyName, 
00306         ListViewSortLastName, 
00307         ListViewSortCompany, 
00308         ListViewSortFirstName 
00309 } AlpContactsDmlFormatNameType;
00310 
00313 typedef enum {
00314         VoiceRingtoneType,
00315         VideoRingtoneType
00316 } AlpContactsDmlRingtoneType;
00317 
00320 #ifdef __cplusplus
00321 extern "C" {
00322 #endif
00323 
00356 alp_status_t alp_contacts_dml_open(AlpDmlH *dmlH, bool changeTrackingOn);
00357 
00366 alp_status_t alp_contacts_dml_close(AlpDmlH dmlH);
00367 
00384 alp_status_t alp_contacts_dml_item_create(
00385                                           AlpContactsDmlItemType itemType,
00386                                           AlpDmlItemH *itemH);
00387 
00401 alp_status_t alp_contacts_dml_item_create_with_custom_fields(
00402                                           AlpDmlH dmlH,
00403                                           AlpContactsDmlItemType itemType,
00404                                           AlpDmlItemH *itemH);
00405 
00418 alp_status_t alp_contacts_dml_item_destroy(AlpDmlItemH itemH);
00419 
00441 alp_status_t alp_contacts_dml_item_set_int32(
00442                       AlpDmlItemH itemH,
00443                       AlpContactsDmlColumnType column,
00444                       const int32_t *value);
00445 
00487 alp_status_t alp_contacts_dml_item_set_string(
00488                       AlpDmlItemH itemH,
00489                       AlpContactsDmlColumnType column,
00490                       const char *value);
00491 
00537 alp_status_t alp_contacts_dml_item_set_blob(
00538                       AlpDmlItemH itemH,
00539                       AlpContactsDmlColumnType column,
00540                       const void *value,
00541                                           int32_t size);
00592 alp_status_t alp_contacts_dml_insert(
00593                       AlpDmlH dmlH,
00594                       AlpDmlItemH itemH,
00595                       AlpLuid *itemLuid);
00596 
00622 alp_status_t alp_contacts_dml_update(
00623                       AlpDmlH dmlH,
00624                       AlpDmlItemH itemH,
00625                       AlpLuid itemLuid);
00626 
00643 alp_status_t alp_contacts_dml_delete(
00644                       AlpDmlH dmlH,
00645                                           AlpContactsDmlItemType itemType,
00646                       AlpLuid itemLuid);
00707 alp_status_t alp_contacts_dml_person_statement_begin(
00708                       AlpDmlH dmlH,
00709                                           AlpLuid personLuid,
00710                                           AlpLuid categoryLuid,
00711                                           bool unfiled,
00712                                           const char * const *contactTypes,
00713                                           int16_t numContactTypes,
00714                                           AlpContactsDmlOrderByType orderBy,
00715                       AlpDmlStatementH *personStmtH,
00716                       int32_t *numResults);
00717 
00775 alp_status_t alp_contacts_dml_person_statement_begin_with_columns(
00776                       AlpDmlH dmlH,
00777                                           AlpLuid personLuid,
00778                                           AlpLuid categoryLuid,
00779                                           bool unfiled,
00780                                           const char * const *contactTypes,
00781                                           int16_t numContactTypes,
00782                                           AlpContactsDmlOrderByType orderBy,
00783                                           const AlpContactsDmlColumnType* columnTypes,
00784                       int16_t numColumnTypes,
00785                       AlpDmlStatementH *personStmtH,
00786                       int32_t *numResults );
00787 
00853 alp_status_t alp_contacts_dml_listview_statement_begin(
00854                       AlpDmlH dmlH,
00855                                           AlpLuid categoryLuid,
00856                                           AlpLuid distributionLuid,
00857                                           bool unfiled,
00858                                           const char * const *contactTypes,
00859                                           int16_t numContactTypes,
00860                                           AlpContactsDmlOrderByType orderBy,
00861                                           int32_t limit, int32_t offset,
00862                                           const char* filterBy, bool filterDataOnly,
00863                       AlpDmlStatementH *listViewStmtH,
00864                       int32_t *totalPersons,
00865                       int32_t *totalItems );
00866 
00867 alp_status_t alp_contacts_dml_listview_statement_begin2(
00868                       AlpDmlH dmlH,
00869                                           AlpLuid categoryLuid,
00870                                           AlpLuid distributionLuid,
00871                                           bool unfiled,
00872                                           const char * const *contactTypes,
00873                                           int16_t numContactTypes,
00874                                           AlpContactsDmlOrderByType orderBy,
00875                                           int32_t limit, int32_t offset,
00876                                           const char* filterBy,
00877                       AlpDmlStatementH *listViewStmtH,
00878                       int32_t *totalPersons );
00879 
00918 alp_status_t alp_contacts_dml_address_statement_begin(
00919                       AlpDmlH dmlH,
00920                       AlpLuid personLuid,
00921                       AlpLuid addressLuid,
00922                       AlpDmlStatementH *addressStmtH,
00923                       int32_t *numResults);
00924 
00968 alp_status_t alp_contacts_dml_address_statement_begin_with_columns(
00969                       AlpDmlH dmlH,
00970                       AlpLuid personLuid,
00971                       AlpLuid addressLuid,
00972                                           const AlpContactsDmlColumnType* columnTypes,
00973                       int16_t numColumnTypes,
00974                       AlpDmlStatementH *addressStmtH,
00975                       int32_t *numResults);
00976 
01007 alp_status_t alp_contacts_dml_custom_label_statement_begin(
01008     AlpDmlH dmlH,
01009     AlpDmlStatementH *customLabelStmtH,
01010     int32_t *numResults);
01011 
01047 alp_status_t alp_contacts_dml_custom_label_statement_begin_with_columns(
01048     AlpDmlH dmlH,
01049         const AlpContactsDmlColumnType* columnTypes,
01050     int16_t numColumnTypes,
01051     AlpDmlStatementH *customLabelStmtH,
01052     int32_t *numResults);
01053 
01102 alp_status_t alp_contacts_dml_contact_statement_begin(
01103                       AlpDmlH dmlH,
01104                       AlpLuid personLuid,
01105                       AlpLuid contactLuid,
01106                       const char * const *contactTypes,
01107                       uint16_t numContactTypes,
01108                       AlpDmlStatementH *contactsStmtH,
01109                       int32_t *numResults);
01110 
01164 alp_status_t alp_contacts_dml_contact_statement_begin_with_columns(
01165                       AlpDmlH dmlH,
01166                       AlpLuid personLuid,
01167                       AlpLuid contactLuid,
01168                       const char * const *contactTypes,
01169                       uint16_t numContactTypes,
01170                                           const AlpContactsDmlColumnType* columnTypes,
01171                                           int16_t numColumnTypes,
01172                       AlpDmlStatementH *contactsStmtH,
01173                       int32_t *numResults);
01174 
01227 alp_status_t alp_contacts_dml_distribution_statement_begin(
01228                       AlpDmlH dmlH,
01229                       AlpLuid distributionLuid,
01230                       const char * const *distributionTypes,
01231                       uint16_t numDistributionTypes,
01232                                           AlpContactsDmlDistributionOrderByType orderBy,
01233                                           int32_t limit, int32_t offset,
01234                       AlpDmlStatementH *distributionStmtH,
01235                       int32_t *numResults);
01236 
01272 alp_status_t alp_contacts_dml_extrafields_statement_begin(
01273                       AlpDmlH dmlH,
01274                       AlpLuid personLuid,
01275                       AlpDmlStatementH *extraFieldsStmtH,
01276                       int32_t *numResults);
01277 
01318 alp_status_t alp_contacts_dml_extrafields_statement_begin_with_columns(
01319                       AlpDmlH dmlH,
01320                       AlpLuid personLuid,
01321                                           const AlpContactsDmlColumnType* columnTypes,
01322                                           int16_t numColumnTypes,
01323                       AlpDmlStatementH *extraFieldsStmtH,
01324                       int32_t *numResults);
01325 
01361 alp_status_t alp_contacts_dml_thumbnail_statement_begin(
01362                       AlpDmlH dmlH,
01363                       AlpLuid personLuid,
01364                       AlpDmlStatementH *thumbnailStmtH,
01365                       int32_t *numResults);
01366 
01407 alp_status_t alp_contacts_dml_thumbnail_statement_begin_with_columns(
01408                       AlpDmlH dmlH,
01409                       AlpLuid personLuid,
01410                                           const AlpContactsDmlColumnType* columnTypes,
01411                                           int16_t numColumnTypes,
01412                       AlpDmlStatementH *thumbnailStmtH,
01413                       int32_t *numResults);
01414 
01426 alp_status_t alp_contacts_dml_statement_next(
01427                       AlpDmlStatementH stmtH);
01428 
01435 alp_status_t alp_contacts_dml_statement_end(
01436                       AlpDmlStatementH stmtH);
01437 
01453 alp_status_t alp_contacts_dml_statement_get_int32(
01454                       AlpDmlStatementH stmtH,
01455                       AlpContactsDmlColumnType column,
01456                       int32_t *value);
01457 
01479 alp_status_t alp_contacts_dml_statement_get_string(
01480                       AlpDmlStatementH stmtH,
01481                       AlpContactsDmlColumnType column,
01482                                           bool copy,
01483                       char **value);
01484 
01511 alp_status_t alp_contacts_dml_statement_get_blob(
01512                       AlpDmlStatementH stmtH,
01513                       AlpContactsDmlColumnType column,
01514                                           bool copy,
01515                       void **value,
01516                                           int32_t *size);
01517 
01547 alp_status_t alp_contacts_dml_statement_get_luids(
01548                       AlpDmlStatementH stmtH,
01549                       AlpLuid *personLuid,
01550                       AlpLuid *itemLuid);
01551 
01552 /* You may add more getter types if needed */
01571 alp_status_t alp_contacts_dml_transaction_begin(
01572                       AlpDmlH dmlH, bool exclusive);
01573 
01580 alp_status_t alp_contacts_dml_transaction_end(AlpDmlH dmlH);
01581 
01588 alp_status_t alp_contacts_dml_transaction_rollback(AlpDmlH dmlH);
01611 alp_status_t alp_contacts_dml_add_memberships(
01612                       AlpDmlH dmlH, AlpLuid personLuid,
01613                       const AlpLuid *categoryLuids,
01614                       AlpLuid membershipLuid,
01615                       int32_t numCategoryLuids);
01616 
01618 alp_status_t alp_contacts_dml_memberships_add(
01619                       AlpDmlH dmlH, AlpLuid personLuid,
01620                       const AlpLuid *categoryIDs,
01621                       AlpLuid membershipLuid,
01622                       int32_t numCategoryIDs) __attribute((deprecated));
01623 
01642 alp_status_t alp_contacts_dml_remove_memberships(
01643                       AlpDmlH dmlH, AlpLuid personLuid,
01644                       const AlpLuid *categoryLuids,
01645                       AlpLuid membershipLuid,
01646                       int32_t numCategoryLuids);
01647 
01649 alp_status_t alp_contacts_dml_memberships_remove(
01650                       AlpDmlH dmlH, AlpLuid personLuid,
01651                       const AlpLuid *categoryIDs,
01652                       AlpLuid membershipLuid,
01653                       int32_t numCategoryIDs) __attribute((deprecated));
01654 
01680 alp_status_t alp_contacts_dml_distribution_add_memberships(
01681                       AlpDmlH dmlH, AlpLuid contactID,
01682                       const AlpLuid *distributionLuids,
01683                       int32_t numDistributionLuids );
01684 
01685 #define alp_contacts_dml_distribution_memberships_add alp_contacts_dml_distribution_add_memberships
01686 
01687 
01702 alp_status_t alp_contacts_dml_distribution_remove_memberships(
01703                       AlpDmlH dmlH, AlpLuid contactID,
01704                       const AlpLuid *distributionLuids,
01705                       int32_t numDistributionLuids );
01706 
01707 #define alp_contacts_dml_distribution_memberships_remove alp_contacts_dml_distribution_remove_memberships
01708 
01757 alp_status_t alp_contacts_dml_distribution_membership_statement_begin(
01758                       AlpDmlH dmlH,
01759                                           AlpLuid contactID,
01760                                           AlpLuid distributionLuid,
01761                                           AlpContactsDmlDistributionMembershipOrderByType orderBy,
01762                       AlpDmlStatementH *distMembershipStmtH,
01763                       int32_t *numResults );
01764 
01795 alp_status_t alp_contacts_dml_person_get_name(
01796                                           AlpDmlStatementH personStmtH,
01797                       AlpContactsDmlFormatNameType formatType,
01798                                           char **name);
01799 
01846 alp_status_t alp_contacts_dml_cid_lookup(
01847                       AlpDmlH dmlH,
01848                       const char *lookupString,
01849                       AlpLuid *personLuid,
01850                                           AlpLuid *contactLuid);
01851 
01861 alp_status_t alp_contacts_dml_get_version(
01862                                           AlpDmlH dmlH,
01863                                           int32_t *version);
01864 
01907 alp_status_t alp_contacts_dml_event_statement_begin(
01908                       AlpDmlH dmlH,
01909                       uint32_t startDay,
01910                       uint32_t startMonth,
01911                       uint32_t endDay,
01912                       uint32_t endMonth,
01913                       uint32_t year,
01914                       AlpDmlStatementH *personStmtH,
01915                       int32_t *numResults);
01916 
01963 alp_status_t alp_contacts_dml_event_statement_begin_with_columns(
01964                       AlpDmlH dmlH,
01965                       uint32_t startDay,
01966                       uint32_t startMonth,
01967                       uint32_t endDay,
01968                       uint32_t endMonth,
01969                       uint32_t year,
01970                                           const AlpContactsDmlColumnType* columnTypes,
01971                                           int16_t numColumnTypes,
01972                       AlpDmlStatementH *personStmtH,
01973                       int32_t *numResults);
01974 
01996 alp_status_t alp_contacts_dml_register_alarm_ui_handler(AlpDmlH dmlH, 
01997         char *appName);
01998 
01999 
02018 alp_status_t alp_contacts_dml_set_next_alarm(AlpDmlH dmlH, AlpLuid personLuid);
02019 
02057 alp_status_t alp_contacts_dml_search_begin(AlpDmlH dmlH, 
02058                       AlpDmlStatementH *personStmtH, char *string,
02059                       int32_t *numResults);
02060 
02062 alp_status_t alp_contacts_dml_search_statement_begin(AlpDmlH dmlH, 
02063                                           char *string,
02064                       AlpDmlStatementH *personStmtH,
02065                       int32_t *numResults) __attribute((deprecated));
02066 
02100 alp_status_t alp_contacts_dml_read_from_vCard_file(AlpDmlH dmlH, 
02101                                           int theDataFd,
02102                                   bool fromExgMgr, bool forModify, GList** personLuids );
02103 
02105 alp_status_t alp_contacts_dml_persons_from_vCard_file(AlpDmlH dmlH, 
02106                                           int theDataFd,
02107                                   bool fromExgMgr, bool forModify, GList** personIDs ) __attribute((deprecated));
02108 
02141 alp_status_t alp_contacts_dml_read_from_vCard_buffer(AlpDmlH dmlH, 
02142         const uint8_t* dataBuf, int32_t dataBufSize, bool fromExgMgr, bool forModify, GList** personLuids );
02143 
02145 alp_status_t alp_contacts_dml_persons_from_vCard_buffer(AlpDmlH dmlH, 
02146         const uint8_t* dataBuf, int32_t dataBufSize, bool fromExgMgr, bool forModify, GList** personIDs ) __attribute((deprecated));
02147 
02162 alp_status_t alp_contacts_dml_write_to_vCard_file(AlpDmlH dmlH, 
02163         int theDataFd, bool toExgMgr, const GList* personLuids );
02164 
02166 alp_status_t alp_contacts_dml_persons_to_vCard_file(AlpDmlH dmlH, 
02167         int theDataFd, bool toExgMgr, GList* personLuids ) __attribute((deprecated));
02168 
02184 alp_status_t alp_contacts_dml_write_to_vCard_buffer(AlpDmlH dmlH, 
02185         uint8_t** dataBuf, int32_t* dataBufSize, bool toExgMgr, const GList* personLuids );
02186 
02188 alp_status_t alp_contacts_dml_persons_to_vCard_buffer(AlpDmlH dmlH, 
02189         uint8_t** dataBuf, int32_t* dataBufSize, bool toExgMgr, GList* personLuids ) __attribute((deprecated));
02190 
02197 AlpDmlH alp_contacts_dml_get_catmgr_handle(AlpDmlH dmlH);
02198 
02207 alp_status_t alp_contacts_dml_duplicate(AlpDmlH dmlH, 
02208         AlpLuid srcContact, AlpLuid *dupedContact );
02209 
02220 alp_status_t alp_contacts_dml_get_category_ringtone(AlpDmlH dmlH, 
02221         AlpLuid categoryLuid, AlpContactsDmlRingtoneType ringtoneType, char** ringtoneMFURL );
02222 
02233 alp_status_t alp_contacts_dml_set_category_ringtone(AlpDmlH dmlH, 
02234         AlpLuid categoryLuid, AlpContactsDmlRingtoneType ringtoneType, const char* ringtoneFilePath );
02235 
02247 alp_status_t alp_contacts_dml_get_person_ringtone(AlpDmlH dmlH, 
02248         AlpLuid personLuid, AlpContactsDmlRingtoneType ringtoneType, char** ringtoneFilePath );
02249 
02265 alp_status_t alp_contacts_dml_monitor_object(AlpDmlH dmlH, 
02266         AlpLuid personLuid, AlpLuid* conflictLuid, AlpHsMonitorPtr* ppMonitor );
02267 
02276 alp_status_t alp_contacts_dml_release_monitor( AlpDmlH dmlH, AlpHsMonitorPtr pMonitor );
02277 
02299 alp_status_t alp_contacts_dml_listview_person_index(
02300                       AlpDmlH dmlH,
02301                       AlpLuid personLuid,
02302                                           AlpLuid categoryLuid,
02303                                           bool unfiled,
02304                                           AlpContactsDmlOrderByType orderBy,
02305                                           const char* filterBy,
02306                       int32_t *index );
02307 
02314 alp_status_t alp_contacts_dml_begin_modify_batch( AlpDmlH dmlH );
02315 
02323 alp_status_t alp_contacts_dml_end_modify_batch( AlpDmlH dmlH, bool batchSucceeded );
02324 
02334 alp_status_t alp_contacts_dml_get_thumbnail_sizes(
02335                                                         uint32_t *largeWidth,
02336                                                         uint32_t *largeHeight,
02337                                                         uint32_t *smallWidth,
02338                                                         uint32_t *smallHeight );
02339 
02343 
02344 #ifdef __cplusplus
02345 }
02346 #endif
02347 
02348 #endif /* ALP_CONTACTS_DML_H_DEFINED */
02349 

Generated on Wed Jul 30 07:06:39 2008 by Doxygen 1.4.6 for ALP SDK + Hiker Documentation

Copyright © 1999-2008 ACCESS CO., LTD. All rights reserved.