IMAPISupport::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 nombre para mostrar del destinatario de la propiedad PR_DISPLAY_NAME (PidTagDisplayName). El parámetro lpszName puede ser NULL.
lpszAdrType
[in] Puntero al tipo de dirección (como FAX, SMTP o X500) del destinatario. El parámetro lpszAdrType no puede ser NULL.
lpszAddress
[in] Puntero a la dirección de mensajería 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
El método IMAPISupport::CreateOneOff se implementa para todos los objetos de soporte técnico del proveedor de servicios. Los proveedores de servicios llaman a CreateOneOff para crear un identificador de entrada para un destinatario único (un destinatario que no pertenece a ninguno de los contenedores de cualquiera de los proveedores de libreta de direcciones cargados actualmente).
Notas para los llamadores
Cuando haya terminado de usar el identificador de entrada devuelto por CreateOneOff, libere la memoria asignada para el identificador de entrada mediante la función MAPIFreeBuffer .
Notas para proveedores de transporte
Admite el formato de encapsulación neutro de transporte (TNEF) y usa el valor de la propiedad PR_SEND_RICH_INFO para determinar si se debe usar TNEF al transportar un mensaje. No admitir TNEF o no enviar un mensaje en este formato cuando se solicita puede ser un problema para clientes basados en formularios o clientes que requieren propiedades MAPI personalizadas. Esto se debe a que TNEF se usa normalmente para enviar propiedades personalizadas para clases de mensajes personalizadas.
Vea también
Propiedad canónica PidTagDisplayName