IMAPISupport::Details
The IMAPISupport::Details
method displays a modal dialog box showing details about a particular address
book entry.
Quick Info
See IMAPISupport
: IUnknown.
HRESULT Details(
|
ULONG FAR * lpulUIParam, |
|
|
LPFNDISMISS lpfnDismiss, |
|
|
LPVOID lpvDismissContext, |
|
|
ULONG cbEntryID,
|
|
|
LPENTRYID lpEntryID,
|
|
|
LPFNBUTTON lpfButtonCallback, |
|
|
LPVOID lpvButtonContext, |
|
|
LPTSTR lpszButtonText, |
|
|
ULONG ulFlags |
|
|
) |
|
Parameters
lpulUIParam
[out] Handle
of the parent window for the returned dialog box.
lpfnDismiss
[in] Pointer
to a function based on the DISMISSMODELESS function prototype. This function is called
when the modeless variety of the details dialog box is dismissed. This parameter
is ignored at present because MAPI does not support a modeless details dialog
box.
lpvDismissContext
[in] Data
that is passed to the function specified by the lpfnDismiss parameter.
This parameter is currently ignored.
cbEntryID
[in] Count of
bytes in the entry identifier pointed to by the lpEntryID parameter.
lpEntryID
[in] Pointer
to the entry identifier for which details are displayed.
lpfButtonCallback
[in] Pointer
to a function based on the LPFNBUTTON function prototype. An LPFNBUTTON
function adds a button to the details dialog box.
lpvButtonContext
[in] Pointer
to data used as a parameter for the function specified by the lpfButtonCallback
parameter.
lpszButtonText
[in] Pointer
to a string containing text to be applied to the added button if that button is
extensible. The lpszButtonText parameter should be NULL if an extensible
button is not needed.
ulFlags
[in] Bitmask
of flags that controls the type of the text for the lpszButtonText
parameter. The following flag can be set:
MAPI_UNICODE
The passed-in
strings are in Unicode format. If the MAPI_UNICODE flag is not set, the strings
are in ANSI format.
Return Values
S_OK
The details
dialog box was successfully displayed for the address book entry.
Remarks
The IMAPISupport::Details
method is implemented for address book provider support objects. Address book
providers call the IMAPISupport::Details method to display a modal
dialog box giving details on a particular entry in the address book. The
lpfButtonCallback, lpvButtonContext, and lpButtonText
parameters can be used to add a button the client has defined to the dialog
box. When the button is chosen, MAPI calls the callback function pointed to by lpfButtonCallback,
passing both the entry identifier of the button and the data in lpvButtonContext.
If an extensible button is not needed, lpszButtonText should be NULL.
See Also