HrOpenABEntryWithProviderUIDSupport

Applies to: Office 2010 | Outlook 2010 | Visual Studio

Performs the same function as the HrOpenABEntryWithProviderUID function except that the HrOpenABEntryWithProviderUIDSupport function opens the entry using the given support object instead of using the session and the address book.

HRESULT HrOpenABEntryWithProviderUIDSupport(
  const MAPIUID *pEmsabpUID,
  LPMAPISUP lpSup,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPCIID lpInterface,
  ULONG ulFlags,
  ULONG FAR * lpulObjType,
  LPUNKNOWN FAR * lppUnk
);

Parameters

• pEmsabpUID
  [in] A pointer to an emsabpUID parameter that identifies the Exchange address book provider that 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.

• lpSup

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

• lpInterface
  [in] A pointer to the interface identifier (IID) of the interface to be used to access the open entry. Passing NULL returns the standard interface of the object. For messaging users, the standard interface is IMailUser : IMAPIProp. For distribution lists it is IDistList : IMAPIContainer, and for containers it is IABContainer : IMAPIContainer. Callers can set lpInterface to the appropriate standard interface or an interface in the inheritance hierarchy.

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

• lpulObjType
  [out] A pointer to the type of the opened entry.

• lppUnk
  [out] A pointer to a pointer of the opened entry.