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