Función de devolución de llamada WABOpenEx (wabapi.h)

[WABOpenEx ya no está disponible para su uso en Windows Vista.]

Proporciona acceso a la Libreta de direcciones de Windows (WAB) a través de una serie de interfaces de objeto. La interfaz raíz es IAddrBook, que es un subconjunto de la implementación MAPI de IAddrBook.

Sintaxis

WABOpenEx Wabopenex;

HRESULT Wabopenex(
  LPADRBOOK *lppAdrBook,
  LPWABOBJECT *lppWABObject,
  LPWAB_PARAM lpWP,
  DWORD Reserved,
  ALLOCATEBUFFER *fnAllocateBuffer,
  ALLOCATEMORE *fnAllocateMore,
  FREEBUFFER *fnFreeBuffer
)
{...}

Parámetros

lppAdrBook

Tipo: LPADRBOOK*

Dirección de un puntero a la interfaz IAddrBook devuelta por la función .

lppWABObject

Tipo: LPWABOBJECT*

Dirección de un puntero a la interfaz IWABObject devuelta por la función .

lpWP

Reserved

fnAllocateBuffer

fnAllocateMore

fnFreeBuffer

Valor devuelto

Tipo: HRESULT

Si esta función de devolución de llamada se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Esta función llama a la función WABOpen y se omiten los parámetros adicionales lpfnAllocateBuffer, lpfnAllocateMore y lpfnFreeBuffer .

WABOpenEx es una versión extendida de WABOpen que permite a los desarrolladores especificar las funciones de asignación de memoria usadas por WAB para devolver búferes al cliente. Si pasa una rutina de asignación, debe pasar las tres rutinas: MAPIAllocateBuffer, MAPIAllocateMore y MAPIFreeBuffer.

Si no necesita la funcionalidad de asignación de memoria adicional de WABOpenEx, use WABOpen en su lugar.

Nota Al especificar rutinas de asignación de memoria con WABOpenEx, estas rutinas reemplazan globalmente las rutinas internas de WAB para este proceso. Otros subprocesos pueden seguir llamando a WABOpen, pero la memoria se asignará con esas rutinas pasadas anteriormente a WABOpenEx.

 

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wabapi.h