HrOpenABEntryUsingDefaultContext

Hace referencia a: Outlook 2013 | Outlook 2016

Realiza la misma función que HrOpenABEntryWithExchangeContext , salvo que usa el emsmdbUID heredado como parámetro pEmsmdbUID . No use esta función a menos que no pueda obtener el emsmdbUID correcto para la llamada a HrOpenABEntryWithExchangeContext.

Propiedad	Valor
Archivo de encabezado:	abhelp.h
Implementado por:	MAPI
Llamado por:	Aplicaciones cliente y proveedores de servicios

HRESULT HrOpenABEntryUsingDefaultContext(
  LPMAPISESSION pmsess,
  LPADRBOOK pAddrBook,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPCIID lpInterface,
  ULONG ulFlags,
  ULONG FAR * lpulObjType,
  LPUNKNOWN FAR * lppUnk
);

Parameters

pmsess

[in] ha iniciado sesión en IMAPISession. No puede ser NULL.

pAddrBook

[in] Libreta de direcciones usada para abrir el identificador de entrada. No puede ser NULL.

cbEntryID

[in] Recuento de bytes del identificador de entrada especificado por el parámetro lpEntryID .

lpEntryID

[in] Puntero al identificador de entrada que representa la entrada de la libreta de direcciones que se va a abrir.

lpInterface

[in] Puntero al identificador de interfaz (IID) de la interfaz que se usa para acceder a la entrada abierta. Al pasar NULL, se devuelve la interfaz estándar del objeto . Para los usuarios de mensajería, la interfaz estándar es IMailUser : IMAPIProp. Para las listas de distribución, es IDistList : IMAPIContainer y, para los contenedores, es IABContainer : IMAPIContainer. Los autores de la llamada pueden establecer lpInterface en la interfaz estándar adecuada o en una interfaz de la jerarquía de herencia.

ulFlags

[in] Máscara de bits de marcas que controla cómo se abre la entrada. Se pueden establecer las siguientes marcas:

MAPI_BEST_ACCESS

Solicita que la entrada se abra con el máximo de permisos de red y cliente permitidos. Por ejemplo, si el cliente tiene permiso de lectura y escritura, el proveedor de libreta de direcciones intenta abrir la entrada con permiso de lectura y escritura. El cliente puede recuperar el nivel de acceso concedido llamando al método IMAPIProp::GetProps de la entrada abierta y recuperando la propiedad PR_ACCESS_LEVEL (PidTagAccessLevel).

MAPI_CACHE_ONLY

Usa solo la libreta de direcciones sin conexión para realizar la resolución de nombres. Por ejemplo, puede usar esta marca para permitir que una aplicación cliente abra la lista global de direcciones (GAL) en modo de intercambio almacenado en caché y acceda a una entrada en esa libreta de direcciones desde la memoria caché sin crear tráfico entre el cliente y el servidor. Esta marca solo es compatible con el proveedor de libreta de direcciones de Exchange.

MAPI_DEFERRED_ERRORS

Permite que la llamada se realice correctamente, posiblemente antes de que la entrada esté totalmente abierta y disponible, lo que implica que las llamadas posteriores a la entrada podrían devolver un error.

MAPI_GAL_ONLY

Usa solo la GAL para realizar la resolución de nombres. Esta marca solo es compatible con el proveedor de libreta de direcciones de Exchange.

MAPI_MODIFY

Solicita que la entrada se abra con permiso de lectura y escritura. Dado que las entradas se abren con acceso de solo lectura de forma predeterminada, los clientes no deben suponer que se concedió el permiso de lectura y escritura independientemente de si se ha establecido MAPI_MODIFY.

MAPI_NO_CACHE

No usa la libreta de direcciones sin conexión para realizar la resolución de nombres. Esta marca solo es compatible con el proveedor de libreta de direcciones de Exchange.

lpulObjType

[out] Puntero al tipo de la entrada abierta.

lppUnk

[out] Puntero a un puntero de la entrada abierta.