IMsgStore::CompareEntryIDs
Hace referencia a: Outlook 2013 | Outlook 2016
Compara dos identificadores de entrada para determinar si hacen referencia a la misma entrada en un almacén de mensajes. MAPI pasa esta llamada a un proveedor de servicios solo si ese proveedor controla los identificadores únicos (UID) de ambos identificadores de entrada que se van a comparar.
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 los objetos correspondientes no están abiertos y no están disponibles en la actualidad.
Comentarios
El método IMsgStore::CompareEntryIDs compara dos identificadores de entrada que pertenecen al almacén de mensajes para determinar si hacen referencia al mismo objeto.
Notas para los llamadores
CompareEntryIDs es útil porque un objeto puede tener más de un identificador de entrada válido (por ejemplo, después de instalar una nueva versión de un proveedor de almacén de mensajes).
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 IMsgStore::CompareEntryIDs para comparar los identificadores de entrada. |