Internet Explorer Address Book Functions

Internet Explorer Address Book Functions


This section describes the functions implemented by the Internet Explorer Address Book.

The Internet Explorer Address Book implements the WABOpen and WabOpenEx functions, that are used to access the interfaces included in the address book.

WABOpen

HRESULT WABOpen(
    LPADRBOOK   * lppAdrBook,
    LPWABOBJECT * lppWABObject,
    LPWAB_PARM    lpWP,          // Can be null
    DWORD         Reserved2
);

Gives access to the address book through a number of object interfaces. The root interface is IAddrBook, which is a subset of the MAPI implementation of IAddrBook.

lppAdrBook
Returned IAddrBook interface.
lppWABObject
Returned IWABObject interface.
lpWP
Address of a WAB_PARAM structure. (This value can be null.)
Reserved2
Reserved; must be zero.

WABOpenEx

HRESULT WABOpenEx(
    LPADRBOOK      * lppAdrBook,
    LPWABOBJECT    * lppWABObject,
    LPWAB_PARM       lpWP,          // Can be null
    DWORD            Reserved2,
    ALLOCATEBUFFER * lpfnAllocateBuffer,
    ALLOCATEMORE   * lpfnAllocateMore,
    FREEBUFFER     * lpfnFreeBuffer
    );

Gives access to the address book through a number of object interfaces. The root interface is IAddrBook, which is a subset of the MAPI implementation of IAddrBook. This function also specifies the memory allocation functions that Internet Explorer Address Book uses to allocate all buffers returned to the client. If you pass in one allocation routine, you must pass them all.

Note When WABOpenEx has been called specifying memory allocation routines, these routines globally replace Internet Explorer Address Book internal routines for this process. Other threads can still call WABOpen, but the memory will still be allocated with those routines previously passed to WABOpenEx. Unless you really need the additional functionality, use WABOpen.

lppAdrBook
Returned IAddrBook interface.
lppWABObject
Returned IWABObject interface.
lpWP
Address of a WAB_PARAM structure. (This value can be null.)
Reserved2
Reserved; must be zero.
lpfnAllocateBuffer
Allocation function in the style of MAPIAllocateBuffer. Can be NULL to use Internet Explorer Address Book internal routines.
lpfnAllocateMore
Allocation function in the style of MAPIAllocateMore. Can be NULL to use Internet Explorer Address Book internal routines.
lpfnFreeBuffer
Buffer function in the style of MAPIFreeBuffer. Can be NULL to use Internet Explorer Address Book internal routines.

© 1997 Microsoft Corporation. All rights reserved. Terms of Use.