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