HrDoABDetailsWithExchangeContext

Applies to: Office 2010 | Outlook 2010 | Visual Studio

Ensures that the OpenEntry method is opened by the expected Exchange address book provider. This function works similarly to IAddrBook::Details, but opens the entryID using the Exchange address book identified by the pEmsmdbUID parameter.

HRESULT HrOpenABEntryWithExchangeContext(
  LPMAPISESSION   pmsess,
  const MAPIUID  *pEmsmdbUID,
  LPADRBOOK pAddrBook,
  ULONG_PTR FAR * lpulUIParam,
  LPFNDISMISS lpfnDismiss,
  LPVOID lpvDismissContext,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPENTRYID lpEntryID,
  LPFNBUTTON lpfButtonCallback,
  LPVOID lpvButtonContext,
  LPSTR lpszButtonText,
  ULONG ulFlags,
);

Parameters

• pmsess
  The logged on IMAPISession. It cannot be NULL.

• pEmsmdbUID
  A pointer to an emsmdbUID that identifies the Exchange Service that contains the Exchange address book provider that is used by the function to open the entry identifier. If the incoming entry identifier is not an Exchange address book provider entry identifier, this parameter is ignored and the function behaves like IAddrBook::OpenEntry. If this parameter is NULL or a zero MAPIUID, this function also acts exactly like IAddrBook::OpenEntry.

• pAddrBook
  [in] The address book used to open the entry identifier. It cannot be NULL.

• lpulUIParam
  [out] A handle to the parent window for the dialog box.

• lpfnDismiss
  [in] A pointer to a function based on the DISMISSMODELESS prototype, or NULL. This member applies only to the modeless version of the dialog box, as indicated by the DIALOG_SDI flag being set. MAPI calls the DISMISSMODELESS function when the user dismisses the modeless address dialog box, informing a client that is calling Details that the dialog box is no longer active.

• lpvDismissContext
  [in] A pointer to context information to pass to the DISMISSMODELESS function pointed to by the lpfnDismiss parameter. This parameter applies only to the modeless version of the dialog box by including the DIALOG_SDI flag in the ulFlags parameter.

• cbEntryID
  [in] The byte count of the entry identifier specified by the lpEntryID parameter.

• lpEntryID
  [in] A pointer to the entry identifier that represents the address book entry to open.

• lpfButtonCallback
  [in] A pointer to a function based on the LPFNBUTTON function prototype. An LPFNBUTTON function adds a button to the details dialog box.

• lpvButtonContext
  [in] A pointer to data that was used as a parameter for the function specified by the lpfButtonCallback parameter.

• lpszButtonText
  [in] A pointer to a string that contains text to be applied to the added button, if that button is extensible. The lpszButtonText parameter should be NULL when an extensible button is not needed.

• ulFlags
  [in] A bitmask of flags that controls the type of the text for the lpszButtonText parameter. The following flags can be set:

  • AB_TELL_DETAILS_CHANGE
    Indicates that Details returns TRUE if changes are actually made to the address; otherwise, Details returns FALSE.

  • DIALOG_MODAL
    Displays the modal version of the common address dialog box. This flag is mutually exclusive with DIALOG_SDI.

  • DIALOG_SDI
    Displays the modeless version of the common address dialog box. This flag is mutually exclusive with DIALOG_MODAL.

  • MAPI_UNICODE
    The passed-in strings are in Unicode format. If the MAPI_UNICODE flag is not set, the strings are in ANSI format.