
HRESULT SeekRowApprox(
ULONG ulNumerator,
ULONG ulDenominator
);
Moves the cursor to an approximate fractional position in a table.
| S_OK | The seek operation was successful. |
| MAPI_E_BUSY | Another operation is in progress that prevents the row seeking operation from starting. Either the operation in progress should be allowed to complete, or it should be stopped. |
Currently not implemented by Internet Explorer Address Book.
HRESULT SetColumns(
LPSPropTagArray lpPropTagArray,
ULONG ulFlags
);
Defines the order of property values, and the order of properties to appear as columns in a table.
| S_OK | The column setting operation was successful. |
| MAPI_E_BUSY | Another operation is in progress that prevents the column setting operation from starting. Either the operation in progress should be allowed to complete, or it should be stopped. |
HRESULT SortTable(
LPSSortOrderSet lpSortCriteria,
ULONG ulFlags
);
Sorts the table rows based on the sort criteria provided.
| S_OK | The sort operation was successful. |
| MAPI_E_BUSY | Another operation is in progress that prevents the sort operation from starting. Either the operation in progress should be allowed to complete, or it should be stopped. |
| MAPI_E_NO_SUPPORT | The table does not support the type of sorting requested. |
| MAPI_E_TOO_COMPLEX | The table cannot perform the operation because the particular sort criteria pointed to by the lpSortCriteria parameter is too complicated. |
Currently not implemented by Internet Explorer Address Book.
Currently not implemented by Internet Explorer Address Book.
The IAddrBook interface supports access to the Internet Explorer Address Book and includes operations such as displaying common dialog boxes, opening containers, messaging users (contacts) and distribution lists (groups) in the address book, and performing name resolution. The organization of the method list for IAddrBook is arranged in v-table order.
HRESULT Address(
ULONG FAR * lpulUIParam
LPADRPARM lpAdrParms,
LPADRLIST FAR * lppAdrList
);
Displays user interface to browse the address book contents and to select recipients from the address book. The UI behavior is specified by a number of flags and parameters in lpAdrParms. Internet Explorer Address Book will not support some of the customization features of the MAPI IAddrBook::Address method. Internet Explorer Address Book will also not support the MAPI Send Options dialog button.
Currently not implemented by Internet Explorer Address Book.
Currently not implemented by Internet Explorer Address Book.
Currently not implemented by Internet Explorer Address Book.
Currently not implemented by Internet Explorer Address Book.
HRESULT CreateOneOff(
LPTSTR lpszName,
LPTSTR lpszAdrType,
LPTSTR lpszAddress,
ULONG ulFlags,
ULONG FAR * lpcbEntryID,
LPENTRYID FAR * lppEntryID
);
Creates an entry identifier for a one-off address.
| MAPI_SEND_NO_RICH_INFO | Indicates the recipient cannot handle formatted message content. If MAPI_SEND_NO_RICH_INFO is set, MAPI sets the recipient's PR_SEND_RICH_INFO property to FALSE. If MAPI_SEND_NO_RICH_INFO is not set, MAPI sets this property to TRUE unless the recipient's messaging address pointed to by lpszAddress is interpreted to be an Internet address. In this case, MAPI sets PR_SEND_RICH_INFO to FALSE. |
| MAPI_UNICODE | Displays the name, address type, and address are in Unicode format. If the MAPI_UNICODE flag is not set, these strings are in ANSI format. |
Currently not implemented by Internet Explorer Address Book.
HRESULT Details(
ULONG FAR * lpulUIParam,
LPFNDISMISS lpfnDismiss,
LPVOID lpvDismissContext,
ULONG cbEntryID,
LPENTRYID lpEntryID,
LPFNBUTTON lpfButtonCallback,
LPVOID lpvButtonContext,
LPTSTR lpszButtonText,
ULONG ulFlags
);
Displays a dialog box showing details for, and allowing editing of, a particular entry in Internet Explorer Address Book. Internet Explorer Address Book does not support the passing in a callback function for buttons through the lpfButtonCallback parameter.
Currently not implemented by Internet Explorer Address Book.
Currently not implemented by Internet Explorer Address Book.
Currently not implemented by Internet Explorer Address Book.
Currently not implemented by Internet Explorer Address Book.
HRESULT GetPAB(
ULONG FAR * lpcbEntryID,
LPENTRYID FAR * lppEntryID
);
Returns the ENTRYID of the default address book container.
Currently not implemented by Internet Explorer Address Book.
Currently not implemented by Internet Explorer Address Book.
HRESULT GetSearchPath(
ULONG ulFlags,
LPSRowSet FAR * lppSearchPath
);
Returns an ordered list of entry identifiers of containers to be included in the name resolution process initiated by the ResolveName method.
| MAPI_UNICODE | Specifies returned strings are in Unicode format. If this flag is not set, the strings are in ANSI format. |
HRESULT NewEntry(
ULONG ulUIParam,
ULONG ulFlags,
ULONG cbEIDContainer,
LPENTRYID lpEIDContainer,
ULONG cbEIDNewEntryTpl,
LPENTRYID lpEIDNewEntryTpl,
ULONG FAR * lpcbEIDNewEntry,
LPENTRYID FAR * lppEIDNewEntry
);
Adds a new entry to the address book.
HRESULT OpenEntry(
ULONG cbEntryID,
LPENTRYID lpEntryID,
LPCIID lpInterface,
ULONG ulFlags,
ULONG FAR * lpulObjType,
LPUNKNOWN FAR * lppUnk
);
Opens a container or mail user object and returns a pointer to the object.
| S_OK | The entry was successfully opened. |
| MAPI_E_NO_ACCESS | An attempt was made to open an entry for which the user has insufficient permissions. |
| MAPI_E_NOT_FOUND | The entry represented by lpEntryID does not exist. |
| MAPI_E_UNKNOWN_ENTRYID | The entry identifier specified in lpEntryID is not recognized. This value is typically returned if the address book provider responsible for the corresponding entry is not open. |
| MAPI_BEST_ACCESS | Specifies to open with best available access rights. |
| MAPI_MODIFY | Requests read/write access. |
| MAPI_DEFERRED_ERRORS | Currently not supported by Internet Explorer Address Book. |
Currently not implemented by Internet Explorer Address Book.
HRESULT PrepareRecips(
ULONG ulFlags,
LPSPropTagArray lpSPropTagArray,
LPADRLIST lpRecipList
);
Prepares a recipient list for later use by the messaging system.
Currently not implemented by Internet Explorer Address Book.
Currently not implemented by Internet Explorer Address Book.
HRESULT ResolveName(
ULONG ulUIParam,
ULONG ulFlags,
LPTSTR lpszNewEntryTitle,
LPADRLIST lpAdrList
);
Resolves a partial recipient list to full addresses.
| S_OK | The name resolution process succeeded. |
| MAPI_E_AMBIGUOUS_RECIP | At least one recipient in the lpAdrList parameter matched more than one entry in the address book. Usually, this value is returned when the MAPI_DIALOG flag is set, prohibiting the display of a dialog box. |
| MAPI_E_NOT_FOUND | At least one recipient in the lpAdrList parameter cannot be resolved. Usually, this value is returned when the MAPI_DIALOG flag is set, prohibiting the display of a dialog box. |
This method optionally displays a dialog box if ambiguous matches are found. ResolveName goes through the address list passed in the lpAdrList parameter, finds all the names not yet resolved, resolves them, and returns the appropriately modified address list. The address list passed in can be one created using the Address method. If a recipient is ambiguous and the MAPI_DIALOG flag is not specified, ResolveName returns MAPI_E_AMBIGUOUS_RECIP.
Note The ADRENTRY items in ADRLIST should be separately allocated, not allocated with AllocateMore. When ResolveNames replaces an entry, it expects to free the ADRENTRY structure by using FreeBuffer and allocate a new one by using AllocateBuffer.
Currently not implemented by Internet Explorer Address Book.
Currently not implemented by Internet Explorer Address Book.
Currently not implemented by Internet Explorer Address Book.
Currently not implemented by Internet Explorer Address Book.
Currently not implemented by Internet Explorer Address Book.
Currently not implemented by Internet Explorer Address Book.
The IDistList interface is used to provide access to distribution lists in modifiable address book containers. This interface can create, copy, and delete distribution lists, in addition to performing name resolution. The organization of the method list for IDistList is arranged in v-table order.
Currently not implemented by Internet Explorer Address Book.
Currently not implemented by Internet Explorer Address Book.
Currently not implemented by Internet Explorer Address Book.
HRESULT CreateEntry(
ULONG cbEntryID,
LPENTRYID lpEntryID,
ULONG ulCreateFlags,
LPMAPIPROP FAR * lppMAPIPropEntry
);
Creates a new entry in the distribution list container. Internet Explorer Address Book supports creation of both IMailUser and IDistList objects.
| 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, while defining a strict match as any two entries having the same display name and messaging address. |
| 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. |
| CREATE_REPLACE | Indicates that duplicate entries replace existing entries within a container. |
HRESULT DeleteEntries(
LPENTRYLIST lpEntries,
ULONG ulFlags
);
Removes one or more entries from the distribution list.
| S_OK | The specified entries have been successfully deleted. |
| MAPI_W_PARTIAL_COMPLETION | The call succeeded, but one or more of the entries could not be deleted. When this warning is returned, the call should be handled as successful. To test for this warning, use the FAILED macro. |
HRESULT DeleteProps(
LPSPropTagArray lpPropTagArray,
LPSPropProblemArray FAR * lppProblems
);
Deletes property values from a distribution list object.
HRESULT GetContentsTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Returns the address to the contents table of the distribution list.
| S_OK | The contents table was successfully retrieved. |
| MAPI_E_BAD_CHARWIDTH | Either the MAPI_UNICODE flag was set and the implementation does not support Unicode, or MAPI_UNICODE was not set and the implementation only supports Unicode. |
| MAPI_E_NO_SUPPORT | The container has no contents and cannot provide a contents table. |
| MAPI_DEFERRED_ERRORS | Currently not supported by Internet Explorer Address Book. |
| MAPI_UNICODE | Indicates the returned strings are in Unicode format. If this flag is not set, the strings are in ANSI format. Not supported in the first version of Internet Explorer Address Book. |
Currently not implemented by Internet Explorer Address Book.
HRESULT GetIDsFromNames(
ULONG cPropNames,
LPMAPINAMEID FAR * lppPropNames,
ULONG ulFlags,
LPSPropTagArray FAR * lppPropTags
);
Provides the property identifiers that correspond to one or more property names.
| S_OK | The identifiers for the specified property names were successfully returned. |
| MAPI_E_NO_SUPPORT | The object does not support named properties. |
| MAPI_E_NOT_ENOUGH_MEMORY | Insufficient memory was available to retrieve the identifiers. |
| MAPI_E_TOO_BIG | The operation cannot be performed because it requires too many property tags be returned. |
| MAPI_W_ERRORS_RETURNED | The call succeeded overall, but one or more property identifiers could not be returned. The corresponding property type for each inaccessible property is set to PT_ERROR and its identifier to zero. When this warning is returned, handle the call as successful. To test for this warning, use the FAILED macro. |
| MAPI_CREATE | Assigns a property identifier to one or more of the names included in the property name array pointed to by lppPropNames if one has not yet been assigned. Internally registers the identifier in the name-to-identifier mapping table. |
Currently not implemented by Internet Explorer Address Book.
Currently not implemented by Internet Explorer Address Book.
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.