IMAPISession::CompareEntryIDsIMAPISession::CompareEntryIDs

適用されます: OutlookApplies to: Outlook

同じオブジェクトを参照しているかどうかを決定する 2 つのエントリ id を比較します。Compares two entry identifiers to determine whether they refer to the same object.

HRESULT CompareEntryIDs(
  ULONG cbEntryID1,
  LPENTRYID lpEntryID1,
  ULONG cbEntryID2,
  LPENTRYID lpEntryID2,
  ULONG ulFlags,
  ULONG FAR * lpulResult
);

ParametersParameters

cbEntryID1cbEntryID1

[in]_LpEntryID1_パラメーターで指定されたエントリの識別子のバイト数です。[in] The byte count in the entry identifier pointed to by the lpEntryID1 parameter.

lpEntryID1lpEntryID1

[in]比較する最初のエントリの識別子へのポインター。[in] A pointer to the first entry identifier to be compared.

cbEntryID2cbEntryID2

[in]_LpEntryID2_パラメーターで指定されたエントリの識別子のバイト数です。[in] The byte count in the entry identifier pointed to by the lpEntryID2 parameter.

lpEntryID2lpEntryID2

[in]比較する 2 番目のエントリの識別子へのポインター。[in] A pointer to the second entry identifier to be compared.

ulFlagsulFlags

[����]�\�񂳂�Ă��܂��B0 �ɂ���K�v������܂��B[in] Reserved; must be zero.

lpulResultlpulResult

[out]比較の結果へのポインター。[out] A pointer to the result of the comparison. 2 つのエントリの識別子が同じオブジェクトを参照する場合は TRUE。それ以外の場合、FALSE です。TRUE if the two entry identifiers refer to the same object; otherwise, FALSE.

�߂�lReturn value

S_OKS_OK

比較は正常に終了しました。The comparison was successful.

MAPI_E_UNKNOWN_ENTRYIDMAPI_E_UNKNOWN_ENTRYID

いずれかまたは両方のパラメーターとして指定されているエントリの識別子を参照しないオブジェクト、可能性のあるこれらのオブジェクトは、現在開かれていないと使用できないためです。One or both of the entry identifiers specified as parameters do not refer to objects, possibly because these objects are currently unopened and unavailable.

備考Remarks

IMAPISession::CompareEntryIDsメソッドは、同じオブジェクトを参照しているかどうかを決定する 1 つのサービス プロバイダーに属している 2 つのエントリ id を比較します。The IMAPISession::CompareEntryIDs method compares two entry identifiers that belong to a single service provider to determine whether they refer to the same object. MAPI は、オブジェクトを担当するサービス ・ プロバイダーを決定するエントリの識別子からMAPIUIDの部分を抽出し、比較を実行するのには、そのログオン オブジェクトのCompareEntryIDsメソッドを呼び出して、します。MAPI extracts the MAPIUID portion from the entry identifiers to determine the service provider responsible for the objects and then calls its logon object's CompareEntryIDs method to perform the comparison.

呼び出し側への注意Notes to callers

CompareEntryIDsメソッドは、オブジェクトが 1 つ以上の有効なエントリ id を持つことができますので便利です。The CompareEntryIDs method is useful because an object can have more than one valid entry identifier. このような状況には、たとえば、サービス ・ プロバイダーの新しいバージョンをインストールした後が発生します。This situation can occur, for example, after a new version of a service provider is installed.

CompareEntryIDsがエラーを返した場合は、比較の結果に基づいてアクションになりません。If CompareEntryIDs returns an error, do not take any action based on the result of the comparison. 代わりにかかる可能性のある最も保守的なアプローチをします。Instead, take the most conservative approach possible. CompareEntryIDsは、一方または両方のエントリの識別子で、無効なMAPIUIDが含まれているなどの場合に失敗する可能性があります。CompareEntryIDs might fail if, for example, one or both of the entry identifiers contain an invalid MAPIUID.

MFCMAPI 参照MFCMAPI reference

MFCMAPI �T���v�� �R�[�h�ł́A���̕\��Q�Ƃ��Ă��������BFor MFCMAPI sample code, see the following table.

�t�@�C��File �֐�Function �R�����gComment
BaseDialog.cppBaseDialog.cpp
CbaseDialog::OnCompareEntryIDsCbaseDialog::OnCompareEntryIDs
MFCMAPI では、 IMAPISession::CompareEntryIDsメソッドを使用して、ユーザーが入力した 2 つのエントリ Id を比較します。MFCMAPI uses the IMAPISession::CompareEntryIDs method to compare two entry IDs that a user enters.

関連項目See also

MAPIUIDMAPIUID

IMAPISession: IUnknownIMAPISession : IUnknown

[�R��h �T���v���Ƃ��� MFCMAPIMFCMAPI as a Code Sample