IAddrBook::PrepareRecips
Aplica-se a: Outlook 2013 | Outlook 2016
Prepara uma lista de destinatários para uso posterior pelo sistema de mensagens.
HRESULT PrepareRecips(
ULONG ulFlags,
LPSPropTagArray lpSPropTagArray,
LPADRLIST lpRecipList
);
Parâmetros
ulFlags
[in] Um bitmask de sinalizadores que controla como a entrada é aberta. O seguinte sinalizador pode ser definido:
MAPI_CACHE_ONLY
Use apenas o catálogo de endereços offline para executar a resolução de nomes. Por exemplo, você pode usar esse sinalizador para permitir que um aplicativo cliente abra a GAL (lista de endereços global) no modo de troca armazenado em cache e acesse uma entrada no catálogo de endereços do cache sem criar tráfego entre o cliente e o servidor. Esse sinalizador tem suporte apenas pelo Provedor de Catálogo de Endereços do Exchange.
lpSPropTagArray
[in] Um ponteiro para uma estrutura SPropTagArray que contém uma matriz de marcas de propriedade que indicam as propriedades, se houver, que exigem atualização. O parâmetro lpSPropTagArray pode ser NULL.
lpRecipList
[in] Um ponteiro para uma estrutura ADRLIST que contém a lista de destinatários.
Valor de retorno
S_OK
A lista de destinatários foi preparada com êxito.
Comentários
Clientes e provedores de serviços chamam o método PrepareRecips para fazer o seguinte:
Verifique se todos os destinatários no parâmetro lpRecipList têm identificadores de entrada de longo prazo.
Verifique se cada destinatário no parâmetro lpRecipList tem as propriedades listadas no parâmetro lpSPropTagArray e que essas propriedades aparecem no início da lista de destinatários.
O MAPI converte os identificadores de entrada de curto prazo de cada destinatário em identificadores de entrada de longo prazo. Se necessário, os identificadores de entrada de longo prazo dos destinatários serão recuperados do provedor de catálogo de endereços apropriado e quaisquer propriedades adicionais serão solicitadas.
Em uma entrada individual do destinatário, as propriedades solicitadas são ordenadas primeiro, seguidas por todas as propriedades que já estavam presentes para a entrada. Se uma ou mais propriedades solicitadas no parâmetro lpSPropTagArray não forem tratadas pelo provedor de catálogo de endereços apropriado, seus tipos de propriedade serão definidos como PT_ERROR. Seus valores de propriedade serão definidos como MAPI_E_NOT_FOUND ou para outro valor que fornece um motivo mais específico para que as propriedades não estejam disponíveis. Cada estrutura SPropValue incluída no parâmetro lpRecipList deve ser alocada separadamente usando as funções MAPIAllocateBuffer e MAPIAllocateMore para que ela possa ser liberada individualmente.
Para obter informações sobre PT_ERROR, consulte Tipos de propriedade.