HrOpenABEntryWithProviderUID

Hace referencia a: Outlook 2013 | Outlook 2016

Abre el entryID mediante la libreta de direcciones de Exchange identificada por pEmsabpUID. Esta función funciona de forma similar a IAddrBook::OpenEntry , salvo que el uso de esta función garantiza que IAddrBook::OpenEntry se abra mediante el proveedor de libreta de direcciones de Exchange esperado.

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

HRESULT HrOpenABEntryWithProviderUID(
  const MAPIUID *pEmsabpUID,
  LPADRBOOK pAddrBook,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPCIID lpInterface,
  ULONG ulFlags,
  ULONG FAR * lpulObjType,
  LPUNKNOWN FAR * lppUnk
);

Parameters

pEmsmdbUID

[in] Puntero a un emsmdbUID que identifica el servicio Exchange que contiene el proveedor de libreta de direcciones de Exchange que esta función debe usar para mostrar detalles sobre el identificador de entrada. Si el identificador de entrada entrante no es un identificador de entrada del proveedor de libreta de direcciones de Exchange, este parámetro se omite y la llamada a la función se comporta como IAddrBook::D etails. Si este parámetro es NULL o mapiuid cero, esta función se comporta como IAddrBook::D etails.

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: IMAPIContainery, 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

Use 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

Use 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 use 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.