IWabObject Interface

This interface provides access to the Microsoft Windows Address Book (WAB) object which contains function pointers to memory allocation functions and database maintenance functions.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IWabObject Methods

Description

GetLastError

Not currently implemented.

AllocateBuffer

Allocates memory for buffers that are passed to WAB methods. The buffer must be freed with IWABObject::FreeBuffer, and may be reallocated with IWABObject::AllocateMore.

AllocateMore

Allocates a memory buffer that is linked to another buffer previously allocated with the IWABObject::AllocateBuffer method.

FreeBuffer

Frees memory allocated with IWABObject::AllocateBuffer or any of the other WAB methods.

Backup

Not currently implemented.

Import

Imports a .wab file into the user's Address Book.

Find

Launches the WAB Find dialog box.

VCardDisplay

Displays properties on a vCard file.

LDAPUrl

Processes an Lightweight Directory Access Protocol (LDAP) URL and displays the results obtained from the URL. If the URL only contains a server name, the WAB launches the Find window with the server name filled in. If the URL contains an LDAP query, the query is processed. If the query has a single result, the WAB shows details about the result; if the query has multiple results, the WAB shows the Find dialog box with multiple search results filled in.

VCardCreate

Translates the properties of a given MailUser object into a vCard file.

VCardRetrieve

Reads a vCard file and creates a MailUser object containing the vCard properties.

GetMe

Retrieves the entry identifier of the object that has been designated as "ME."

SetMe

Designates a particular contact as the ME object.

GetLastError

FUNCTION IWABObject_GetLastError ( _
  BYVAL pIWabObject AS DWORD PTR _
, BYVAL hResultCode AS LONG _
, BYVAL ulFlags AS DWORD _
, BYREF lppMAPIError AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIWabObject[3] USING IWABObject_GetLastError (pIWabObject, hResultCode, ulFlags, lppMAPIError) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

AllocateBuffer

FUNCTION IWABObject_AllocateBuffer ( _
  BYVAL pIWabObject AS DWORD PTR _
, BYVAL cbsize AS DWORD _
, BYREF lppBuffer AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIWabObject[4] USING IWABObject_AllocateBuffer (pIWabObject, cbsize, lppBuffer) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

AllocateMore

FUNCTION IWABObject_AllocateMore ( _
  BYVAL pIWabObject AS DWORD PTR _
, BYVAL cbsize AS DWORD _
, BYVAL lpObject AS DWORD _
, BYREF lppBuffer AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIWabObject[5] USING IWABObject_AllocateMore (pIWabObject, cbsize, lpObject, lppBuffer) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

FreeBuffer

FUNCTION IWABObject_FreeBuffer ( _
  BYVAL pIWabObject AS DWORD PTR _
, BYVAL lpBuffer AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIWabObject[6] USING IWABObject_FreeBuffer (pIWabObject, lpBuffer) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

Backup

FUNCTION IWABObject_Backup ( _
  BYVAL pIWabObject AS DWORD PTR _
, BYREF lpFileName AS ASCIIZ _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIWabObject[7] USING IWABObject_Backup (pIWabObject, lpFileName) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

Import

FUNCTION IWABObject_Import ( _
  BYVAL pIWabObject AS DWORD PTR _
, BYREF lpImportParam AS ASCIIZ _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIWabObject[8] USING IWABObject_Import (pIWabObject, lpImportParam) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

Find

FUNCTION IWABObject_Find ( _
  BYVAL pIWabObject AS DWORD PTR _
, BYVAL lpIAB AS DWORD _
, BYVAL hWnd AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIWabObject[9] USING IWABObject_Find (pIWabObject, lpIAB, hWnd) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

VCardDisplay

FUNCTION IWABObject_VCardDisplay ( _
  BYVAL pIWabObject AS DWORD PTR _
, BYVAL lpIAB AS DWORD _
, BYVAL hWnd AS DWORD _
, BYREF lpszFileName AS ASCIIZ _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIWabObject[10] USING IWABObject_VCardDisplay (pIWabObject, lpIAB, hWnd, lpszFileName) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

LDAPUrl

FUNCTION IWABObject_LDAPUrl ( _
  BYVAL pIWabObject AS DWORD PTR _
, BYVAL lpIAB AS DWORD _
, BYVAL hWnd AS DWORD _
, BYVAL ulFlags AS DWORD _
, BYREF lpszURL AS ASCIIZ _
, BYREF lppMailUser AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIWabObject[11] USING IWABObject_LDAPUrl (pIWabObject, lpIAB, hWnd, ulFlags, lpszURL, lppMailUser) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

VCardCreate

FUNCTION IWABObject_VCardCreate ( _
  BYVAL pIWabObject AS DWORD PTR _
, BYVAL lpIAB AS DWORD _
, BYVAL ulFlags AS DWORD _
, BYREF lpszVCard AS ASCIIZ _
, BYVAL lpMailUser AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIWabObject[12] USING IWABObject_VCardCreate (pIWabObject, lpIAB, ulFlags, lpszVCard, lpMailUser) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

VCardRetrieve

FUNCTION IWABObject_VCardRetrieve ( _
  BYVAL pIWabObject AS DWORD PTR _
, BYVAL lpIAB AS DWORD _
, BYVAL ulFlags AS DWORD _
, BYREF lpszVCard AS ASCIIZ _
, BYREF lpMailUser AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIWabObject[13] USING IWABObject_VCardRetrieve (pIWabObject, lpIAB, ulFlags, lpszVCard, lpMailUser) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetMe

FUNCTION IWABObject_GetMe ( _
  BYVAL pIWabObject AS DWORD PTR _
, BYVAL lpIAB AS DWORD _
, BYVAL ulFlags AS DWORD _
, BYREF lpdwAction AS DWORD _
, BYREF lpsbEID AS SBinary _
, BYVAL ulParam AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIWabObject[14] USING IWABObject_GetMe (pIWabObject, lpIAB, ulFlags, lpdwAction, lpsbEID, ulParam) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

SetMe

FUNCTION IWABObject_SetMe ( _
  BYVAL pIWabObject AS DWORD PTR _
, BYVAL lpIAB AS DWORD _
, BYVAL ulFlags AS DWORD _
, BYREF sbEID AS SBinary _
, BYVAL ulParam AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIWabObject[15] USING IWABObject_SetMe (pIWabObject, lpIAB, ulFlags, sbEID, ulParam) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION