IAddrBook::ResolveName Method

Resolves a partial recipient list to full addresses.

Syntax

HRESULT ResolveName(
    ULONG_PTR ulUIParam,
    ULONG ulFlags,
    LPTSTR lpszNewEntryTitle,
    ADRLIST *lpAdrList
);

Parameters

ulUIParam

ULONG_PTR

Value of type ULONG_PTR that specifies the parent window handle.

ulFlags

ULONG

Value of type ULONG that specifies flags that affect behavior.

MAPI_DIALOG

Displays a dialog box to prompt the user for additional name-resolution information. If this flag is not set, no dialog box is displayed.

WAB_RESOLVE_ALL_EMAILS

Causes name resolution to check against every e-mail address of every entry, instead of checking against the entry's default e-mail address. This makes name resolution slow; avoid using this flag if speed is important.

WAB_RESOLVE_NO_ONE_OFFS

Prevents the WAB from resolving valid e-mail addresses or name/e-mail address pairs as one-off addresses after the initial resolution attempt fails. If resolution fails, the default behavior turns the information from a valid name/e-mail pair or e-mail address into a one-off address.

WAB_RESOLVE_NEED_CERT

Causes name resolution to succeed only if the matching entry has certificate data that can be returned on resolution.

WAB_RESOLVE_NO_NOT_FOUND_UI

Suppresses the WAB UI that typically follows unsuccessful name resolution.

WAB_RESOLVE_USE_CURRENT_PROFILE

Restricts the name resolution to contacts corresponding to the current Identity only, in Profile- or Identity-enabled WAB sessions. The name resolution first looks for an exact match within the list of the Identities private folders. If no match is found in the Identities folders, the WAB searches all the shared folders, followed by the LDAP. If this flag is not specified, the WAB searches against all its contents, irrespective of whether the WAB is profile enabled.

WAB_RESOLVE_FIRST_MATCH

Causes the WAB to return the first entry that matches the given criteria. Once the WAB finds the first entry, it does not look for any other matches.

WAB_RESOLVE_LOCAL_ONLY

Causes the WAB to skip name resolution on any LDAP servers even if such servers have been configured for name resolution. This flag is useful if you want to restrict your resolution or search to the contents within the WAB.

lpszNewEntryTitle

LPTSTR

Pointer to a string that specifies the title for the IAddrBook::NewEntry dialog box.

lpAdrList

ADRLIST

Pointer to a variable of type ADRLIST that specifies the address list containing property lists to match. On output, lpAdrList receives a pointer to a variable containing an address list of resolved recipients.

Return Value

HRESULT

The method can return one of the following values.

Return code Description
S_OK

The name resolution process succeeded.

MAPI_E_AMBIGUOUS_RECIP

At least one recipient in the lpAdrList parameter matched more than one entry in the address book. Usually, this value is returned when the MAPI_DIALOG flag is set, prohibiting the display of a dialog box.

MAPI_E_NOT_FOUND

At least one recipient in the lpAdrList parameter cannot be resolved. Usually, this value is returned when the MAPI_DIALOG flag is set, prohibiting the display of a dialog box.

 

Remarks

ResolveName will optionally display a dialog box if ambiguous matches are found. ResolveName goes through the address list passed in lpAdrList, finds all the unresolved names, resolves them, and returns the appropriately modified address list. The address list passed in can be a list created using the IAddrBook::Address method.

If a recipient is ambiguous and the MAPI_DIALOG flag is not specified, ResolveName will return MAPI_E_AMBIGUOUS_RECIPIENT.

Note  The ADRENTRY items in the ADRLIST should be separately allocated, NOT allocated with AllocateMore. When ResolveName replaces an entry, the ADRENTRY is freed through the action of FreeBuffer. A new entry is allocated by AllocateMore.

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Product

Internet Explorer 5

Header

Wabiab.h

DLL

Wab32.dll

See Also

IAddrBook

 

 

Send comments about this topic to Microsoft

Build date: 6/30/2010