IMsgServiceAdmin::SetPrimaryIdentity
Hace referencia a: Outlook 2013 | Outlook 2016
Designa un servicio de mensajes para que sea el proveedor de la identidad principal para el perfil.
HRESULT SetPrimaryIdentity(
LPMAPIUID lpUID,
ULONG ulFlags
);
Parameters
lpUID
[in] Puntero a la estructura MAPIUID que contiene el identificador único del servicio de mensajes para proporcionar la identidad principal, o NULL, que indica que SetPrimaryIdentity debe borrar la identidad actual.
ulFlags
[entrada] Reservado; debe ser cero.
Valor devuelto
S_OK
Al servicio de mensajes se le asignó correctamente el proveedor de la identidad principal.
MAPI_E_NO_ACCESS
SetPrimaryIdentity intentó designar un servicio de mensajes que tiene la marca de SERVICE_NO_PRIMARY_IDENTITY establecida en su propiedad PR_RESOURCE_FLAGS (PidTagResourceFlags).
Comentarios
El método IMsgServiceAdmin::SetPrimaryIdentity establece un servicio de mensajes como proveedor de la identidad principal del perfil. La identidad principal suele ser el usuario que ha iniciado sesión en el servicio de mensajes. Se representa mediante tres propiedades:
PR_IDENTITY_DISPLAY (PidTagIdentityDisplay)
PR_IDENTITY_ENTRYID (PidTagIdentityEntryId)
PR_IDENTITY_SEARCH_KEY (PidTagIdentitySearchKey)
Cada proveedor de servicios del servicio de mensajes designado establece estas tres propiedades en el nombre para mostrar, el identificador de entrada y la clave de búsqueda del usuario de mensajería que proporciona la identidad principal. Los clientes pueden recuperar el identificador de entrada de la identidad principal llamando al método IMAPISession::QueryIdentity .
La propiedad PR_RESOURCE_FLAGS se establece en STATUS_PRIMARY_IDENTITY para cada proveedor que sea miembro del servicio de mensajes que proporciona la identidad principal y para SERVICE_PRIMARY_IDENTITY para el servicio de mensajes. Cuando un proveedor de servicios no puede proporcionar la identidad principal para su servicio de mensajes, establece PR_RESOURCE_FLAGS en STATUS_NO_PRIMARY_IDENTITY. SetPrimaryIdentity establece la propiedad PR_RESOURCE_FLAGS de cada servicio de mensajes que no proporciona la identidad principal a SERVICE_NO_PRIMARY_IDENTITY.
Cada proveedor de servicios de mensajes sobre el que MAPI tiene información puede establecer una identidad para cada uno de sus usuarios cuando un cliente inicia sesión en el servicio. Sin embargo, dado que MAPI admite conexiones a varios proveedores de servicios para cada sesión MAPI, no hay ninguna definición firme de la identidad de un usuario determinado para la sesión MAPI en su conjunto; La identidad de un usuario depende de qué servicio esté implicado. Los clientes pueden llamar a SetPrimaryIdentity para designar una de las muchas identidades establecidas para un usuario por los servicios de mensajes como identidad principal para ese usuario.