HrDoABDetailsWithProviderUID

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 entryID using the Exchange address book identified by pEmsabpUID.

Header file:

abhelp.h

Implemented by:

MAPI

Called by:

Client applications and service providers

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

Parameters

  • pEmsabpUID
    [in] A pointer to an emsabpUID that identifies the Exchange address book provider this function should use to display details on the entry identifier. If the incoming entry identifier is not an Exchange address book provider entry identifier, this parameter is ignored and the function call acts exactly like IAddrBook::Details. If this parameter is NULL or a zero MAPIUID, this function also acts exactly like IAddrBook::Details.

  • 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.