IAddrBook::Details
Hace referencia a: Outlook 2013 | Outlook 2016
Muestra un cuadro de diálogo que muestra detalles sobre una entrada de libreta de direcciones determinada.
HRESULT Details(
ULONG_PTR FAR * lpulUIParam,
LPFNDISMISS lpfnDismiss,
LPVOID lpvDismissContext,
ULONG cbEntryID,
LPENTRYID lpEntryID,
LPFNBUTTON lpfButtonCallback,
LPVOID lpvButtonContext,
LPSTR lpszButtonText,
ULONG ulFlags
);
Parameters
lpulUIParam
[in] Puntero a un identificador de la ventana primaria del cuadro de diálogo.
lpfnDismiss
[in] Puntero a una función basada en el prototipo DISMISSMODELESS o NULL. Este miembro solo se aplica a la versión modeless del cuadro de diálogo, como indica la marca de DIALOG_SDI que se está estableciendo. MAPI llama a la función DISMISSMODELESS cuando el usuario descarta el cuadro de diálogo de dirección del modelo, informando a un cliente que llama a Details de que el cuadro de diálogo ya no está activo.
lpvDismissContext
[in] Puntero a la información de contexto que se va a pasar a la función DISMISSMODELESS a la que apunta el parámetro lpfnDismiss . Este parámetro solo se aplica a la versión modeless del cuadro de diálogo, ya que incluye la marca DIALOG_SDI en el parámetro ulFlags .
cbEntryID
[in] Recuento de bytes en el identificador de entrada al que apunta el parámetro lpEntryID .
lpEntryID
[in] Puntero al identificador de entrada de la entrada para la que se muestran los detalles.
lpfButtonCallback
[in] Puntero a una función basada en el prototipo de función LPFNBUTTON . Una función LPFNBUTTON agrega un botón al cuadro de diálogo de detalles.
lpvButtonContext
[in] Puntero a los datos que se usaron como parámetro para la función especificada por el parámetro lpfButtonCallback .
lpszButtonText
[in] Puntero a una cadena que contiene texto que se va a aplicar al botón agregado, si ese botón es extensible. El parámetro lpszButtonText debe ser NULL si no necesita un botón extensible.
ulFlags
[in] Máscara de bits de marcas que controla el tipo de texto para el parámetro lpszButtonText . Se pueden establecer las siguientes marcas:
AB_TELL_DETAILS_CHANGE
Indica que Details devuelve S_OK si realmente se realizan cambios en la dirección; De lo contrario, Details devuelve S_FALSE.
DIALOG_MODAL
Mostrar la versión modal del cuadro de diálogo de dirección común, que siempre se muestra en clientes que no son de Outlook. Esta marca se excluye mutuamente con DIALOG_SDI.
DIALOG_SDI
Mostrar la versión modeless del cuadro de diálogo de dirección común. Esta marca se omite para clientes que no son de Outlook.
MAPI_UNICODE
Las cadenas pasadas están en formato Unicode. Si no se establece la marca de MAPI_UNICODE, las cadenas están en formato ANSI.
Valor devuelto
S_OK
El cuadro de diálogo de detalles se mostró correctamente para la entrada de la libreta de direcciones.
Comentarios
Las aplicaciones cliente llaman al método Details para mostrar un cuadro de diálogo que proporciona detalles sobre una entrada determinada en la libreta de direcciones. Puede usar los parámetros lpfButtonCallback, lpvButtonContext y lpszButtonText para agregar un botón definido por el cliente al cuadro de diálogo. Cuando se hace clic en el botón, MAPI llama a la función de devolución de llamada a la que apunta lpfButtonCallback, pasando tanto el identificador de entrada del botón como los datos de lpvButtonContext. Si no necesita un botón extensible, lpszButtonText debe ser NULL.
Details admite cadenas de caracteres Unicode; Las cadenas Unicode se convierten al formato de cadena de caracteres multibyte (MBCS) antes de que se muestren en el cuadro de diálogo de detalles.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| BaseDialog.cpp |
CBaseDialog::OnOpenEntryID |
MFCMAPI usa el método Details para mostrar un cuadro de diálogo que muestra los detalles de una entrada de libreta de direcciones. |