IAddrBook::CompareEntryIDs
Hace referencia a: Outlook 2013 | Outlook 2016
Compara dos identificadores de entrada que pertenecen a un proveedor de libreta de direcciones determinado para determinar si hacen referencia al mismo objeto de libreta de direcciones.
HRESULT CompareEntryIDs(
ULONG cbEntryID1,
LPENTRYID lpEntryID1,
ULONG cbEntryID2,
LPENTRYID lpEntryID2,
ULONG ulFlags,
ULONG FAR * lpulResult
);
Parameters
cbEntryID1
[in] Recuento de bytes en el identificador de entrada al que apunta el parámetro lpEntryID1 .
lpEntryID1
[in] Puntero al primer identificador de entrada que se va a comparar.
cbEntryID2
[in] Recuento de bytes en el identificador de entrada al que apunta el parámetro lpEntryID2 .
lpEntryID2
[in] Puntero al segundo identificador de entrada que se va a comparar.
ulFlags
[entrada] Reservado; debe ser cero.
lpulResult
[out] Puntero al resultado de la comparación. El contenido de lpulResult se establece en TRUE si los dos identificadores de entrada hacen referencia al mismo objeto; De lo contrario, el contenido se establece en FALSE.
Valor devuelto
S_OK
La llamada se ha realizado correctamente y devuelva el valor esperado o los valores.
MAPI_E_UNKNOWN_ENTRYID
Ningún proveedor de libreta de direcciones reconoce uno o ambos identificadores de entrada pasados con los parámetros lpEntryID1 o lpEntryID2 .
Comentarios
Las aplicaciones cliente y los proveedores de servicios llaman al método CompareEntryIDs para comparar dos identificadores de entrada que pertenecen a un único proveedor de libreta de direcciones para determinar si hacen referencia al mismo objeto. CompareEntryIDs es útil porque un objeto puede tener más de un identificador de entrada válido. Esta situación puede producirse, por ejemplo, después de instalar una nueva versión de un proveedor de libreta de direcciones.
MAPI pasa esta llamada al proveedor de libreta de direcciones que es responsable de los identificadores de entrada, determinando el proveedor adecuado haciendo coincidir la estructura MAPIUID en los identificadores de entrada con la estructura MAPIUID registrada por el proveedor.
Si los dos identificadores de entrada hacen referencia al mismo objeto, CompareEntryIDs establece el contenido del parámetro lpulResult en TRUE; si hacen referencia a objetos diferentes, CompareEntryIDs establece el contenido en FALSE. En cualquier caso, CompareEntryIDs devuelve S_OK. Si CompareEntryIDs devuelve un error, que puede producirse si ningún proveedor de libreta de direcciones ha registrado una estructura MAPIUID que coincida con la de los identificadores de entrada, los clientes y proveedores no deben realizar ninguna acción en función del resultado de la comparación. En su lugar, deben adoptar el enfoque más conservador para la acción que se está realizando.