IAddrBook::Address
Hace referencia a: Outlook 2013 | Outlook 2016
Muestra el cuadro de diálogo Libreta de direcciones de Outlook.
HRESULT Address(
ULONG_PTR FAR * lpulUIParam,
LPADRPARM lpAdrParms,
LPADRLIST FAR * lppAdrList
);
Parameters
lpulUIParam
[entrada, salida] Puntero a un identificador de la ventana primaria del cuadro de diálogo. En la entrada, siempre se debe pasar un identificador de ventana. En la salida, si el miembro ulFlags del parámetro lpAdrParms está establecido en DIALOG_SDI, se devuelve el identificador de ventana del cuadro de diálogo modeless. Consulte Comentarios.
lpAdrParms
[entrada, salida] Puntero a una estructura ADRPARM que controla la presentación y el comportamiento del cuadro de diálogo de dirección.
lppAdrList
[entrada, salida] Puntero a un puntero a una estructura ADRLIST que contiene información de destinatario. En la entrada, este parámetro puede ser NULL o apuntar a un puntero válido. En la salida, este parámetro apunta a un puntero a la información de destinatario válida.
Valor devuelto
S_OK
El cuadro de diálogo dirección común se mostró correctamente.
Comentarios
Si el miembro ulFlags del parámetro lpAdrParms está establecido en DIALOG_SDI anticipar la devolución del identificador de ventana del cuadro de diálogo modeless en la salida, se omite en Outlook; la versión modal del cuadro de diálogo siempre se muestra en clientes que no son de Outlook.
La estructura ADRLIST que mapi ha devuelto al autor de la llamada a través del parámetro lppAdrList contiene una matriz de estructuras ADRENTRY , una estructura para cada destinatario. Cuando se pasa al método IMessage::ModifyRecipients de un mensaje saliente en el parámetro lpMods , la estructura ADRLIST se puede usar para actualizar su lista de destinatarios.
Cada estructura ADRENTRY de la estructura ADRLIST contiene cero o más estructuras SPropValue , una estructura para cada propiedad establecida para el destinatario. Puede haber cero estructuras SPropValue cuando se usa el cuadro de diálogo presentado por el método Address para quitar un destinatario. Cuando hay una o varias estructuras SPropValue , se usa la estructura ADRENTRY correspondiente para agregar o actualizar un destinatario. Se puede resolver el destinatario, lo que indica que una de las estructuras SPropValue describe la propiedad PR_ENTRYID del destinatario (PidTagEntryId) o no resuelta, lo que indica que falta la propiedad PR_ENTRYID .
Además de PR_ENTRYID, los destinatarios resueltos incluyen las siguientes propiedades:
PR_RECIPIENT_TYPE (PidTagRecipientType)
PR_DISPLAY_NAME (PidTagDisplayName)
PR_ADDRTYPE (PidTagAddressType)
PR_DISPLAY_TYPE (PidTagDisplayType)
La estructura ADRLIST que pasa el autor de la llamada puede tener un tamaño diferente de la estructura que devuelve MAPI. Si MAPI debe devolver una estructura ADRLIST mayor, libera la estructura original y asigna una nueva. Al asignar memoria para la estructura ADRLIST , asigne la memoria para cada estructura SPropValue por separado. Para obtener más información sobre cómo asignar y liberar estructuras ADRLIST , vea Managing Memory for ADRLIST and SRowSet Structures (Administración de memoria para estructuras ADRLIST y SRowSet).
Address devuelve inmediatamente si la marca de DIALOG_SDI se establece en el miembro ulFlags de la estructura ADRPARM en el parámetro lpAdrParms . La marca de DIALOG_SDI se omite para los clientes que no son de Outlook. Si se omite DIALOG_SDI, se mostrará la versión modal del cuadro de diálogo y no se debe esperar un puntero a un identificador en lpulUIParam.
Address admite cadenas de caracteres Unicode en la estructura ADRPARM si se especificó AB_UNICODEUI en el miembro ulFlags de ADRPARM en el parámetro lpAdrParms y admite cadenas de caracteres Unicode en ADRLIST. Las cadenas Unicode se convierten al formato de cadena de caracteres multibyte (MBCS) antes de que se muestren en el cuadro de diálogo libreta de direcciones de Outlook.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| MAPIStoreFunctions.cpp |
OpenOtherUsersMailboxFromGal |
MFCMAPI usa el método Address para permitir que el usuario seleccione qué buzón se va a abrir. |