IAddrBook::CreateOneOff
Aplica-se a: Outlook 2013 | Outlook 2016
Cria um identificador de entrada para um endereço único.
HRESULT CreateOneOff(
LPSTR lpszName,
LPSTR lpszAdrType,
LPSTR lpszAddress,
ULONG ulFlags,
ULONG FAR * lpcbEntryID,
LPENTRYID FAR * lppEntryID
);
Parâmetros
Lpszname
[in] Um ponteiro para o valor da propriedade PR_DISPLAY_NAME do destinatário (PidTagDisplayName). O parâmetro lpszName pode ser NULL.
lpszAdrType
[in] Um ponteiro para o tipo de endereço do destinatário, como FAX ou SMTP. O parâmetro lpszAdrType não pode ser NULL.
lpszAddress
[in] Um ponteiro para o endereço do destinatário. O parâmetro lpszAddress não pode ser NULL.
ulFlags
[in] Um bitmask de sinalizadores que afeta o destinatário único. Os seguintes sinalizadores podem ser definidos:
MAPI_SEND_NO_RICH_INFO
O destinatário não pode lidar com o conteúdo da mensagem formatada. Se MAPI_SEND_NO_RICH_INFO for definido, o MAPI definirá a propriedade PR_SEND_RICH_INFO do destinatário (PidTagSendRichInfo) como FALSE. Se MAPI_SEND_NO_RICH_INFO não estiver definido, o MAPI definirá essa propriedade como TRUE, a menos que o endereço de mensagens do destinatário apontado por lpszAddress seja interpretado como um endereço da Internet. Nesse caso, MAPI define PR_SEND_RICH_INFO como FALSE.
MAPI_UNICODE
O nome de exibição, o tipo de endereço e o endereço estão no formato Unicode. Se o sinalizador MAPI_UNICODE não estiver definido, essas cadeias de caracteres estarão no formato ANSI.
lpcbEntryID
[out] Um ponteiro para a contagem de bytes no identificador de entrada apontado pelo parâmetro lppEntryID .
lppEntryID
[out] Um ponteiro para um ponteiro para o identificador de entrada do destinatário único.
Valor de retorno
S_OK
O identificador de entrada único foi criado com êxito.
Comentários
Os clientes chamam o método CreateOneOff para criar um identificador de entrada para um destinatário único – um destinatário que não pertence a nenhum dos contêineres de nenhum dos provedores de catálogo de endereços carregados no momento. Os destinatários pontuais podem ter qualquer tipo de endereço compatível com um dos provedores de catálogo de endereços ativos para a sessão.
Destinatários pontuais normalmente são criados com um modelo para seu tipo de endereço específico. O provedor de catálogo de endereços que dá suporte ao tipo de endereço fornece o modelo. Um usuário de um aplicativo cliente insere as informações relevantes no modelo.
O MAPI dá suporte a cadeias de caracteres Unicode para os parâmetros de nome de exibição, tipo de endereço e endereço do CreateOneOff.
O sinalizador MAPI_SEND_NO_RICH_INFO controla se o texto formatado em Formato de Texto Avançado (RTF) é enviado junto com cada mensagem. O TNEF (Formato de Encapsulamento Neutro de Transporte) – um formato usado para transmitir texto formatado – é enviado pela maioria dos provedores de transporte, independentemente de como o destinatário define sua propriedade PR_SEND_RICH_INFO . Isso não é um problema para clientes de mensagens que trabalham com mensagens interpessoais. No entanto, como o TNEF normalmente é usado para enviar propriedades personalizadas para classes de mensagens personalizadas, não dar suporte a ela pode ser um problema para clientes ou clientes baseados em formulário que exigem propriedades MAPI personalizadas. Para obter mais informações, consulte Envio de Mensagens com TNEF.
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| Mapiabfunctions.cpp |
AddOneOffAddress |
O MFCMAPI usa o método CreateOneOff para criar uma ID de entrada para um endereço que não é encontrado em nenhum catálogo de endereços. |