IAddrBook::CreateOneOff
Hace referencia a: Outlook 2013 | Outlook 2016
Crea un identificador de entrada para una dirección única.
HRESULT CreateOneOff(
LPSTR lpszName,
LPSTR lpszAdrType,
LPSTR lpszAddress,
ULONG ulFlags,
ULONG FAR * lpcbEntryID,
LPENTRYID FAR * lppEntryID
);
Parameters
lpszName
[in] Puntero al valor de la propiedad PR_DISPLAY_NAME del destinatario (PidTagDisplayName). El parámetro lpszName puede ser NULL.
lpszAdrType
[in] Puntero al tipo de dirección del destinatario, como FAX o SMTP. El parámetro lpszAdrType no puede ser NULL.
lpszAddress
[in] Puntero a la dirección del destinatario. El parámetro lpszAddress no puede ser NULL.
ulFlags
[in] Máscara de bits de marcas que afecta al destinatario único. Se pueden establecer las siguientes marcas:
MAPI_SEND_NO_RICH_INFO
El destinatario no puede controlar el contenido del mensaje con formato. Si se establece MAPI_SEND_NO_RICH_INFO, MAPI establece la propiedad PR_SEND_RICH_INFO del destinatario (PidTagSendRichInfo) en FALSE. Si no se establece MAPI_SEND_NO_RICH_INFO, MAPI establece esta propiedad en TRUE a menos que la dirección de mensajería del destinatario a la que apunta lpszAddress se interprete como una dirección de Internet. En este caso, MAPI establece PR_SEND_RICH_INFO en FALSE.
MAPI_UNICODE
El nombre para mostrar, el tipo de dirección y la dirección están en formato Unicode. Si no se establece la marca de MAPI_UNICODE, estas cadenas están en formato ANSI.
lpcbEntryID
[out] Puntero al recuento de bytes en el identificador de entrada al que apunta el parámetro lppEntryID .
lppEntryID
[out] Puntero a un puntero al identificador de entrada del destinatario único.
Valor devuelto
S_OK
El identificador de entrada único se creó correctamente.
Comentarios
Los clientes llaman al método CreateOneOff para crear un identificador de entrada para un destinatario único, un destinatario que no pertenece a ninguno de los contenedores de ninguno de los proveedores de libreta de direcciones cargados actualmente. Los destinatarios únicos pueden tener cualquier tipo de dirección compatible con uno de los proveedores de libretas de direcciones activos para la sesión.
Normalmente, los destinatarios únicos se crean con una plantilla para su tipo de dirección determinado. El proveedor de libreta de direcciones que admite el tipo de dirección proporciona la plantilla. Un usuario de una aplicación cliente escribe la información pertinente en la plantilla.
MAPI admite cadenas de caracteres Unicode para el nombre para mostrar, el tipo de dirección y los parámetros de dirección de CreateOneOff.
La marca MAPI_SEND_NO_RICH_INFO controla si el texto con formato en formato de texto enriquecido (RTF) se envía junto con cada mensaje. La mayoría de los proveedores de transporte envían el formato de encapsulación neutro de transporte (TNEF), un formato que se usa para transmitir texto con formato, independientemente de cómo el destinatario establezca su propiedad PR_SEND_RICH_INFO . No se trata de un problema para los clientes de mensajería que funcionan con mensajes de tipo interpersonal. Sin embargo, dado que TNEF se usa normalmente para enviar propiedades personalizadas para clases de mensajes personalizadas, no admitirlo puede ser un problema para clientes basados en formularios o clientes que requieren propiedades MAPI personalizadas. Para obtener más información, consulte Envío de mensajes con TNEF.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| Mapiabfunctions.cpp |
AddOneOffAddress |
MFCMAPI usa el método CreateOneOff para crear un identificador de entrada para una dirección que no se encuentra en ninguna libreta de direcciones. |