IMAPISupport::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 nome de exibição do destinatário da propriedade PR_DISPLAY_NAME (PidTagDisplayName). O parâmetro lpszName pode ser NULL.
lpszAdrType
[in] Um ponteiro para o tipo de endereço (como FAX, SMTP ou X500) do destinatário. O parâmetro lpszAdrType não pode ser NULL.
lpszAddress
[in] Um ponteiro para o endereço de mensagens 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
O método IMAPISupport::CreateOneOff é implementado para todos os objetos de suporte do provedor de serviços. Os provedores de serviços chamam 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 atualmente carregados).
Notas para chamadores
Quando terminar de usar o identificador de entrada retornado pelo CreateOneOff, libere a memória alocada para o identificador de entrada usando a função MAPIFreeBuffer .
Anotações para provedores de transporte
Dê suporte ao TNEF (Formato de Encapsulamento Neutro de Transporte) e use o valor da propriedade PR_SEND_RICH_INFO para determinar se você deve usar o TNEF ao transportar uma mensagem. Não dar suporte ao TNEF ou não enviar uma mensagem nesse formato quando ela é solicitada pode ser um problema para clientes ou clientes baseados em formulários que exigem propriedades MAPI personalizadas. Isso ocorre porque o TNEF normalmente é usado para enviar propriedades personalizadas para classes de mensagens personalizadas.
Confira também
Propriedade Canônica PidTagDisplayName