LPFNBUTTON
Applies to: Office 2010 | Outlook 2010 | Visual Studio
Defines a callback function that MAPI calls to activate an optional button control in an address book dialog box. This button is typically a Details button.
Header file: |
Mapidefs.h |
Defined function implemented by: |
Service providers |
Defined function called by: |
MAPI |
SCODE (STDMETHODCALLTYPE FAR * LPFNBUTTON)(
ULONG_PTR ulUIParam,
LPVOID lpvContext,
ULONG cbEntryID,
LPENTRYID lpSelection,
ULONG ulFlags
);
Parameters
ulUIParam
[in] Handle of the parent windows for any dialog boxes or windows this function displays.lpvContext
[in] Pointer to an arbitrary value passed to the callback function when MAPI calls it. This value can represent an address of significance to the client application. Typically, for C++ code, lpvContext represents a pointer to a C++ object.cbEntryID
[in] Size, in bytes, of the entry identifier pointed to by the lpSelection parameter.lpSelection
[in] Pointer to the entry identifier defining the selection in the dialog box.ulFlags
[in] Reserved; must be zero.
Return Value
- S_OK
The call succeeded and has returned the expected value or values.
Remarks
Client applications call a callback function based on the LPFNBUTTON prototype to define a button in a details dialog box. The client passes a pointer to the callback function in calls to the IAddrBook::Details method.
Service providers call a hook function based on the LPFNBUTTON prototype to define a button in a details dialog box. The provider passes a pointer to this hook function in calls to the IMAPISupport::Details method.
In both cases, when the dialog box is displayed and the user chooses the defined button, MAPI calls LPFNBUTTON.