IAddrBook::Address Method

Displays the common address book dialog box.


HRESULT Address(
    ULONG_PTR *lpulUIParam,
    ADRPARM *lpAdrParms,
    ADRLIST **lppAdrList


  • lpulUIParam
    ULONG_PTR Pointer to a variable of type ULONG_PTR that specifies the handle of the parent window of the dialog box. On input, a window handle must always be passed. On output, if the DIALOG_SDI flag is set in the lpAdrParms parameter ADRPARM structure, the window handle of the modeless dialog box is returned.
  • lpAdrParms
    ADRPARM Pointer to a variable of type ADRPARM that specifies the presentation and behavior of the addressing dialog box.
  • lppAdrList
    ADRLIST Address of a pointer to a variable of type ADRLIST that specifies the current recipient list. On output, lppAdrList receives the address of a pointer to the ADRLIST where the IAddrBook::Address is stored. The user can set lppAdrList to NULL on input.

Return Value


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


The behavior of the addressing dialog box is specified by flags and parameters in lpAdrParms. The Windows Address Book (WAB) does not support some of the customization features of the MAPI Address method. The WAB also does not support the MAPI send options dialog button.


Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server


Internet Explorer 4.0





See Also




Send comments about this topic to Microsoft

Build date: 6/30/2010