IABLogon Interface

IID_IABLogon

{00020314-0000-0000-C000-000000000046}

The IABLogon interface is used to access resources in an address book provider.

For general information about the methods of IABLogon, see Implementing Service Provider Logon.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IABLogon Methods

Description

GetLastError

Returns a MAPIERROR structure containing information about the previous address book provider error.

Logoff

Initiates the logoff process.

OpenEntry

Opens a container, messaging user, or distribution list and returns a pointer to an interface implementation to provide further access.

CompareEntryIDs

Compares two entry identifiers to determine if they refer to the same object.

Advise

Registers to receive notification of specified events affecting a container, messaging user, or distribution list.

Unadvise

Cancels the sending of notifications previously set up with a call to the IABLogon::Advise method.

OpenStatusEntry

Opens the provider's status object.

OpenTemplateID

Opens a recipient entry that has data residing in a host address book provider.

GetOneOffTable

Returns a table of one-off templates for creating recipients to be added to the recipient list of an outgoing message.

PrepareRecips

Prepares a recipient list for later use by the messaging system.

GetLastError

FUNCTION IABLogon_GetLastError ( _
  BYVAL pIABLogon AS DWORD PTR _
, BYVAL hResultCode AS LONG _
, BYVAL ulFlags AS DWORD _
, BYREF lppMAPIError AS DWORD _
  ) AS LONG

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

END FUNCTION

Logoff

FUNCTION IABLogon_Logoff ( _
  BYVAL pIABLogon AS DWORD PTR _
, BYVAL ulFlags AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIABLogon[4] USING IABLogon_Logoff (pIABLogon, ulFlags) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

OpenEntry

FUNCTION IABLogon_OpenEntry ( _
  BYVAL pIABLogon AS DWORD PTR _
, BYVAL cbEntryID AS DWORD _
, BYVAL lpEntryID AS ENTRYID PTR _
, BYREF lpInterface AS GUID _
, BYVAL ulFlags AS DWORD _
, BYREF lpulObjType AS DWORD _
, BYREF lppUnk AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIABLogon[5] USING IABLogon_OpenEntry (pIABLogon, cbEntryID, lpEntryID, lpInterface, ulFlags, lpulObjType, lppUnk) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

CompareEntryIDs

FUNCTION IABLogon_CompareEntryIDs ( _
  BYVAL pIABLogon AS DWORD PTR _
, BYVAL cbEntryID1 AS DWORD _
, BYVAL lpEntryID1 AS ENTRYID PTR _
, BYVAL cbEntryID2 AS DWORD _
, BYVAL lpEntryID2 AS ENTRYID PTR _
, BYVAL ulFlags AS DWORD _
, BYREF lpulResult AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIABLogon[6] USING IABLogon_CompareEntryIDs (pIABLogon, cbEntryID1, lpEntryID1, cbEntryID2, lpEntryID2, ulFlags, lpulResult) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

Advise

FUNCTION IABLogon_Advise ( _
  BYVAL pIABLogon AS DWORD PTR _
, BYVAL cbEntryID AS DWORD _
, BYVAL lpEntryID AS ENTRYID PTR _
, BYVAL ulEventMask AS DWORD _
, BYVAL lpAdviseSink AS DWORD _
, BYREF lpulConnection AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIABLogon[7] USING IABLogon_Advise (pIABLogon, cbEntryID, lpEntryID, ulEventMask, lpAdviseSink, lpulConnection) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

Unadvise

FUNCTION IABLogon_Unadvise ( _
  BYVAL pIABLogon AS DWORD PTR _
, BYVAL ulConnection AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIABLogon[8] USING IABLogon_Unadvise (pIABLogon, ulConnection) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

OpenStatusEntry

FUNCTION IABLogon_OpenStatusEntry ( _
  BYVAL pIABLogon AS DWORD PTR _
, BYREF lpInterface AS GUID _
, BYVAL ulFlags AS DWORD _
, BYREF lpulObjType AS DWORD _
, BYREF lppMAPIStatus AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIABLogon[9] USING IABLogon_OpenStatusEntry (pIABLogon, lpInterface, ulFlags, lpulObjType, lppMAPIStatus) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

OpenTemplateID

FUNCTION IABLogon_OpenTemplateID ( _
  BYVAL pIABLogon AS DWORD PTR _
, BYVAL cbTemplateID AS DWORD _
, BYVAL lpTemplateID AS DWORD _
, BYVAL ulTemplateFlags AS DWORD _
, BYVAL lpMAPIPropData AS DWORD _
, BYREF lpInterface AS GUID _
, BYREF lppMAPIPropNew AS DWORD _
, BYVAL lpMAPIPropSibling AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIABLogon[10] USING IABLogon_OpenTemplateID (pIABLogon, cbTemplateID, lpTemplateID, ulTemplateFlags, lpMAPIPropData, lpInterface, lppMAPIPropNew, lpMAPIPropSibling) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetOneOffTable

FUNCTION IABLogon_GetOneOffTable ( _
  BYVAL pIABLogon AS DWORD PTR _
, BYVAL ulFlags AS DWORD _
, BYREF lppTable AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIABLogon[11] USING IABLogon_GetOneOffTable (pIABLogon, ulFlags, lppTable) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

PrepareRecips

FUNCTION IABLogon_PrepareRecips ( _
  BYVAL pIABLogon AS DWORD PTR _
, BYVAL ulFlags AS DWORD _
, BYREF lpPropTagArray AS SPropTagArray _
, BYVAL lpRecipList AS ADRLIST PTR _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pIABLogon[12] USING IABLogon_PrepareRecips (pIABLogon, ulFlags, lpPropTagArray, lpRecipList) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION