IMSProvider::CompareStoreIDs
Aplica-se a: Outlook 2013 | Outlook 2016
Compara dois identificadores de entrada do repositório de mensagens para determinar se eles se referem ao mesmo objeto de repositório.
HRESULT CompareStoreIDs(
ULONG cbEntryID1,
LPENTRYID lpEntryID1,
ULONG cbEntryID2,
LPENTRYID lpEntryID2,
ULONG ulFlags,
ULONG FAR * lpulResult
);
Parâmetros
cbEntryID1
[in] O tamanho, em bytes, do identificador de entrada apontado pelo parâmetro lpEntryID1.
lpEntryID1
[in] Um ponteiro para o primeiro identificador de entrada a ser comparado.
cbEntryID2
[in] O tamanho, em bytes, do identificador de entrada apontado pelo parâmetro lpEntryID2.
lpEntryID2
[in] Um ponteiro para o segundo identificador de entrada a ser comparado.
ulFlags
[in] Reservados; deve ser zero.
lpulResult
[out] Um ponteiro para o resultado retornado da comparação. TRUE se os dois identificadores de entrada se referirem ao mesmo objeto; caso contrário, FALSE.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
Comentários
MAPI chama o método IMSProvider::CompareStoreIDs quando processa uma chamada para o método IMAPISession::OpenMsgStore . CompareStoreIDs é chamado neste ponto para determinar qual seção de perfil, se houver, está associada ao armazenamento de mensagens que está sendo aberto. Uma chamada CompareStoreIDs pode ser feita quando nenhum armazenamento de mensagens está aberto para um provedor de loja específico. Além disso, o MAPI também chama CompareStoreIDs quando processa uma chamada de provedor de armazenamento para o método IMAPISupport::OpenProfileSection .
Os identificadores de entrada comparados pelo CompareStoreIDs são ambos para a DLL (biblioteca de link dinâmico) do provedor de loja atual e são identificadores de entrada de loja não desembrulhados. Para obter mais informações sobre como empacotar identificadores de entrada do repositório, consulte IMAPISupport::WrapStoreEntryID.
Comparar identificadores de entrada é útil porque um objeto pode ter mais de um identificador de entrada válido. Isso pode ocorrer, por exemplo, depois que uma nova versão de um provedor de repositório de mensagens for instalada.
Confira também
IMAPISupport::OpenProfileSection