ModifyAddressCard

The ModifyAddressCard function modifies an address card in the Contacts database. Before calling this function, an application must call the SetMask function once for each property to be changed in the address card.

Syntax

BOOL ModifyAddressCard(AddressCard *pac, PEGOID oidCard, int *pindex);

At a Glance

Header file: Addrstor.h
Platforms: H/PC
Versions: 1.0 and later

Parameters

pac
Pointer to an AddressCard structure that contains new data for the address card. An application typically uses the OpenAddressCard or GetAddressCardProperties function to fill the structure, and then modifies certain members before calling ModifyAddressCard.
oidCard
Object identifier of the address card to be modified.
pindex
Pointer to a variable that receives the position index of the modified address card. The index is relative to the beginning of the database and is based on the current sort order.

Return Values

Returns TRUE if successful, or FALSE otherwise.

Remarks

The Contacts database must have been opened by a previous call to the OpenAddressBook function. For more information, see Contacts Database.

See Also

AddAddressCard, GetAddressCardProperties, OpenAddressBook, OpenAddressCard, SetMask