IMAPISupport::OpenProfileSection
Hace referencia a: Outlook 2013 | Outlook 2016
Abre una sección del perfil actual y devuelve un puntero IProfSect para obtener más acceso.
HRESULT OpenProfileSection(
LPMAPIUID lpUid,
ULONG ulFlags,
LPPROFSECT FAR * lppProfileObj
);
Parameters
lpUid
[in] Puntero a la estructura MAPIUID que identifica la sección de perfil que se va a abrir. Si se pasa NULL para el parámetro lpUid , se abre la sección de perfil del autor de la llamada.
ulFlags
[in] Máscara de bits de marcas que controla cómo se abre la sección de perfil. Se pueden establecer las siguientes marcas:
MAPI_DEFERRED_ERRORS
Permite que OpenProfileSection devuelva correctamente, posiblemente antes de que el autor de la llamada pueda acceder completamente a la sección de perfil. Si no se puede acceder a la sección de perfil, realizar una llamada de objeto posterior puede dar lugar a un error.
MAPI_MODIFY
Solicita permiso de lectura y escritura. De forma predeterminada, los objetos se abren como de solo lectura y los autores de llamadas no deben funcionar en la suposición de que se ha concedido el permiso de lectura y escritura.
lppProfileObj
[out] Puntero a un puntero a la sección de perfil abierto.
Valor devuelto
S_OK
La sección de perfil se abrió correctamente.
MAPI_E_NO_ACCESS
Se intentó modificar una sección de perfil de solo lectura o acceder a un objeto para el que el autor de la llamada no tiene permisos suficientes.
MAPI_E_NOT_FOUND
No hay una sección de perfil asociada al identificador de entrada pasado en lpEntryID.
MAPI_E_UNKNOWN_FLAGS
Se usaron marcas reservadas o no admitidas y, por lo tanto, la operación no se completó.
Comentarios
El método IMAPISupport::OpenProfileSection se implementa para todos los objetos de soporte técnico. Los proveedores de servicios y los servicios de mensajes llaman a OpenProfileSection para abrir una sección de perfil y recuperar un puntero a su implementación de interfaz IProfSect .
Notas para los llamadores
OpenProfileSection abre secciones de perfil como de solo lectura, a menos que establezca la marca MAPI_MODIFY en el parámetro ulFlags y su permiso sea suficiente. Establecer esta marca no garantiza el permiso de lectura y escritura; Los permisos que se le conceden dependen del nivel de acceso y del objeto .
Si OpenProfileSection intenta abrir una sección de perfil inexistente como de solo lectura, devuelve MAPI_E_NOT_FOUND. Si OpenProfileSection intenta abrir una sección de perfil inexistente como de lectura y escritura, crea la sección de perfil y devuelve el puntero IProfSect .