IMAPISupport::SetProviderUID
Aplica-se a: Outlook 2013 | Outlook 2016
Registra uma estrutura MAPIUID que representa exclusivamente o provedor de serviços.
HRESULT SetProviderUID(
LPMAPIUID lpProviderID,
ULONG ulFlags
);
Parâmetros
lpProviderID
[in] Um ponteiro para a estrutura MAPIUID que identifica o catálogo de endereços ou o provedor do repositório de mensagens.
ulFlags
Reservados; deve ser zero.
Valor de retorno
S_OK
A estrutura MAPIUID foi registrada com êxito.
Comentários
O método IMAPISupport::SetProviderUID é implementado para objetos de suporte ao catálogo de endereços e ao provedor do repositório de mensagens. Esses provedores chamam SetProviderUID para registrar um identificador exclusivo descrito na estrutura MAPIUID apontada por lpProviderID. Os provedores incluem esse identificador em todos os identificadores de entrada que eles criam.
O MAPI usa a estrutura MAPIUID quando envia mensagens de saída para o spooler MAPI e para determinar o provedor apropriado para lidar com solicitações de cliente. Por exemplo, quando um cliente chama o método IMAPISession::OpenEntry , MAPI examina a parte MAPIUID do identificador de entrada, mapeia-a para o provedor que o passou para SetProviderUID e chama o OpenEntry desse provedor.
Notas para chamadores
Chame SetProviderUID em tempo de logon para registrar sua estrutura MAPIUID . O MAPI permite que provedores de catálogo de endereços e repositório de mensagens registrem vários identificadores. Quando você faz várias chamadas para SetProviderUID, ele sempre adiciona a estrutura MAPIUID ao conjunto de estruturas MAPIUID do provedor, mesmo que o MAPIUID seja uma duplicata. SetProviderUID não pode remover um MAPIUID.