IMAPISupport::CompareEntryIDs
Hace referencia a: Outlook 2013 | Outlook 2016
Compara dos identificadores de entrada para determinar si hacen referencia al mismo objeto.
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. TRUE si los dos identificadores de entrada hacen referencia al mismo objeto; De lo contrario, FALSE.
Valor devuelto
S_OK
La comparación se realizó correctamente.
MAPI_E_UNKNOWN_ENTRYID
Uno o ambos identificadores de entrada especificados como parámetros no hacen referencia a objetos válidos, posiblemente porque actualmente no están abiertos y no están disponibles.
Comentarios
El método IMAPISupport::CompareEntryIDs se implementa para la libreta de direcciones y los objetos de soporte técnico del proveedor del almacén de mensajes. CompareEntryIDs compara dos identificadores de entrada que pertenecen a un único proveedor de servicios para determinar si hacen referencia al mismo objeto. MAPI extrae la parte MAPIUID de los identificadores de entrada para determinar el proveedor de servicios responsable de los objetos. A continuación, MAPI llama al método CompareEntryIDs de su objeto de inicio de sesión para realizar la comparación.
Notas para los llamadores
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 servicios.
Si CompareEntryIDs devuelve un error, no realice ninguna acción en función del resultado de la comparación. En su lugar, adopte el enfoque más conservador posible. CompareEntryIDs podría producir un error si, por ejemplo, uno o ambos identificadores de entrada contienen una estructura MAPIUID no válida.