IMAPISession::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, posiblemente porque estos objetos están actualmente sin abrir y no están disponibles.
Comentarios
El método IMAPISession::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 y, a continuación, llama al método CompareEntryIDs de su objeto de inicio de sesión para realizar la comparación.
Notas para los llamadores
El método 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 un MAPIUID no válido.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| BaseDialog.cpp |
CbaseDialog::OnCompareEntryIDs |
MFCMAPI usa el método IMAPISession::CompareEntryIDs para comparar dos identificadores de entrada que escribe un usuario. |