IMAPISupport::SetProviderUID
Hace referencia a: Outlook 2013 | Outlook 2016
Registra una estructura MAPIUID que representa de forma única el proveedor de servicios.
HRESULT SetProviderUID(
LPMAPIUID lpProviderID,
ULONG ulFlags
);
Parameters
lpProviderID
[in] Puntero a la estructura MAPIUID que identifica la libreta de direcciones o el proveedor del almacén de mensajes.
ulFlags
Reservados; debe ser cero.
Valor devuelto
S_OK
La estructura MAPIUID se registró correctamente.
Comentarios
El método IMAPISupport::SetProviderUID se implementa para la libreta de direcciones y los objetos de soporte técnico del proveedor del almacén de mensajes. Estos proveedores llaman a SetProviderUID para registrar un identificador único descrito en la estructura MAPIUID a la que apunta lpProviderID. Los proveedores incluyen este identificador en todos los identificadores de entrada que crean.
MAPI usa la estructura MAPIUID cuando envía mensajes salientes a la cola MAPI y para determinar el proveedor adecuado para controlar las solicitudes de cliente. Por ejemplo, cuando un cliente llama al método IMAPISession::OpenEntry , MAPI examina la parte MAPIUID del identificador de entrada, lo asigna al proveedor que lo pasó a SetProviderUID y llama a OpenEntry de ese proveedor.
Notas para los llamadores
Llame a SetProviderUID en el momento del inicio de sesión para registrar la estructura MAPIUID . MAPI permite que los proveedores de libreta de direcciones y almacén de mensajes registren varios identificadores. Al realizar varias llamadas a SetProviderUID, siempre agrega la estructura MAPIUID al conjunto de estructuras MAPIUID del proveedor, incluso si MAPIUID es un duplicado. SetProviderUID no puede quitar una MAPIUID.