IWABObject::SetMe method (wabapi.h)

Designates a particular contact as the ME object.

Syntax

HRESULT SetMe(
  LPADRBOOK lpIAB,
  ULONG     ulFlags,
  SBinary   sbEID,
  HWND      hwnd
);

Parameters

lpIAB

Type: IAddrBook*

Pointer to an IAddrBook interface that specifies the address book.

ulFlags

Type: ULONG

Value of type ULONG that specifies flags affecting behavior.

MAPI_DIALOG

Causes a selection dialog box to be displayed.

sbEID

Type: SBinary

Value of type SBinary that specifies the entry identifier of the contact that should be tagged as ME.

hwnd

Type: ULONG

Value of type ULONG that specifies the parent window handle for displaying dialog boxes. Cast the parent HWND to a ULONG before passing.

Return value

Type: HRESULT

Returns S_OK if successful, or an error code otherwise.

Remarks

If the calling application provides an entry identifier to set as the ME object, and ulFlags is set to zero, the entry corresponding to the entry identifier is designated as "ME" and any previous ME entry is cleared of this setting.

If the calling application specifies MAPI_DIALOG in the ulFlags parameter, the Windows Address Book (WAB) displays a ME selection dialog box which contains a list of contacts from which the user can choose. If the application passed in an entry identifier, the entry corresponding to the entry identifier is pre-selected in the contact list. If the application did not pass in an entry identifier, and a ME entry currently exists in the WAB, the current ME entry is pre-selected in the contact list.

Passing a combination of no flags and no entry identifiers is not valid.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wabapi.h
DLL Wab32.dll