Contents Index Topic Contents | ||
Previous Topic: IABContainer::CopyTo Next Topic: IABContainer::DeleteEntries |
IABContainer::CreateEntry
HRESULT CreateEntry( ULONG cbEntryID, LPENTRYID lpEntryID, ULONG ulCreateFlags, LPMAPIPROP lppMAPIPropEntry );Creates a new entry in the address book container. Internet Explorer Address Book supports creating new address book objects IDistList for a distribution list and IMailUser for a messaging user. Internet Explorer Address Book might support creation of subcontainers in a future version.
- Returns S_OK if successful.
- cbEntryID
- Size, in bytes, of the existing entry identifier to copy from, in the lpEntryID parameter.
- lpEntryID
- Entry identifier of the object to copy from.
- ulCreateFlags
- Bitmask of flags that control how entry creation is performed. The following flags can be set:
- CREATE_CHECK_DUP_LOOSE
- Indicates a loose level should be used for duplicate entry checking, which returns more matches than setting a strict level with the CREATE_CHECK_DUP_STRICT flag. For example, a provider can define a loose match as any two entries having the same display name.
- CREATE_CHECK_DUP_STRICT
- Indicates a strict level should be used for duplicate entry checking, which returns fewer matches than setting a loose level with the CREATE_CHECK_DUP_LOOSE flag. For example, a provider can define a strict match as any two entries having the same display name and messaging address.
- CREATE_REPLACE
- Indicates that duplicate entries replace existing entries within a container.
- lppMAPIPropEntry
- Returned property interface to a new object.
These flags are valid only for the instance of the object returned by CreateEntry. There is no way in the API to get the SetProps or the SaveChanges method to check for duplicates on an object returned by OpenEntry. To do duplicate checking on SaveChanges of an object returned by OpenEntry, the caller would have to do the following:
- Modify any of the name fields in the user interface: PR_SURNAME, PR_GIVEN_NAME, PR_COMPANY_NAME, or PR_DISPLAYNAME.
- Delete the old contact.
- Use CreateEntry to create a new entry with the CREATE_CHECK_DUP_LOOSE flag, set the properties, and save the changes. On failure, restore the original entry.
Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.