Developer

API Reference

IBTPBAPClient_PullVCardEntry()

Brew Release
Brew MP 1.0.2
See Also
IBTPBAPClient_RetrieveVCardEntry
IBTPBAPClient_PullPhoneBook
IBTPBAPClient_PullVCardListing
Description
This function should be called to pull a vCard entry from the PSE. cObject indicates the phonebook folder and pszVCardName name specifies the name of the vCard object. If cObject is AEEBTPBAP_OBJTYPE_USER_DEFINED, pszVCardName should have the path of the vCard appended with name of vCard (e.g, "/root/telecom/pb/2.vcf" )
Parameters
  • _me
    [in]:
    pointer to the IBTPBAPClient object
  • cObject
    [in]:
    phonebook object type
  • pszVCardName
    [in]:
    name of the vCard.
  • cFormat
    [in]:
    requested format (vCard 2.1 or 3.0).
  • lAttribMask
    [in]:
    attribute Mask. One of the AEEBTPBAPAttribMask value.
Interface
Prototype
   IBTPBAPClient_PullVCardEntry (IBTPBAPClient* _me,
                                 AEEBTPBAPObjectType cObject,  
                                 const char* pszVCardName,                                  
                                 BTOBEXFormat cFormat,
                                 uint64 cAttribMask);
Return
AEE_SUCCESS - the request to pull the phone book object has been queued and that AEEBTPBAPCLI_EV_VCARD_LISTING_DONE event will be generated at a later time. AEE_ENOMEMORY - could not queue command due to lack of memory AEE_EBADPARM - invalid input parameters AEE_BADSTATE - bad state(No connection exists).
Side Effect
None
Comment
None
  • Follow