WABOpenEx Function

Do not use. Provides access to the Windows Address Book (WAB) through a number of object interfaces. The root interface is IAddrBook, which is a subset of the MAPI implementation of IAddrBook.

Syntax

HRESULT WABOpenEx(
              LPADRBOOK *lppAdrBook,
              LPWABOBJECT *lppWABObject,
              LPWAB_PARAM lpWABParam,
  __reserved  DWORD Reserved2,
              ALLOCATEBUFFER *lpfnAllocateBuffer,
              ALLOCATEMORE *lpfnAllocateMore,
              FREEBUFFER *lpfnFreeBuffer
);

Parameters

lppAdrBook
LPADRBOOK

Address of a pointer to the IAddrBook interface returned by the function.

lppWABObject
LPWABOBJECT

Address of a pointer to the IWABObject interface returned by the function.

lpWABParam
LPWAB_PARAM

Pointer to a WAB_PARAM structure. Supported by Microsoft Internet Explorer 4.0 or later.

Reserved2
DWORD

Reserved. Must be set to 0.

lpfnAllocateBuffer
ALLOCATEBUFFER

Pointer to a function that specifies the MAPIAllocateBuffer-style allocation function. Set to NULL to use WAB internal routines.

lpfnAllocateMore
ALLOCATEMORE

Pointer to a function that specifies the MAPIAllocateMore-style allocation function. Set to NULL to use WAB internal routines.

lpfnFreeBuffer
FREEBUFFER

Pointer to a function that specifies the MAPIFreeBuffer-style memory freeing function. Set to NULL to use WAB internal routines.

Return Value

HRESULT

If the function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Note  In Windows Vista and later, this function has been deprecated. It calls the WABOpen function, and the extra parameters lpfnAllocateBuffer, lpfnAllocateMore, and lpfnFreeBuffer are ignored.

WABOpenEx is an extended version of WABOpen that enables developers to specify the memory allocation functions used by WAB to return buffers to the client. If you pass one allocation routine, you must pass all three routines: MAPIAllocateBuffer, MAPIAllocateMore, and MAPIFreeBuffer.

If you do not need the extra memory allocation functionality of WABOpenEx, use WABOpen instead.

Note  When you specify memory allocation routines with WABOpenEx, these routines globally replace the WAB internal routines for this process. Other threads may still call WABOpen, but the memory will be allocated with those routines previously passed to WABOpenEx.

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Product

Internet Explorer 5.5

DLL

Wab32.dll

 

 

Send comments about this topic to Microsoft

Build date: 6/30/2010

Community Additions

ADD
Show: