PidTagSearchKey 標準プロパティ
適用対象: Outlook 2013 | Outlook 2016
検索の相関オブジェクトを識別するバイナリに匹敵するキーが含まれます。
| プロパティ | 値 |
|---|---|
| 関連するプロパティ: |
PR_SEARCH_KEY |
| 識別子: |
0x300B |
| データの種類 : |
PT_BINARY |
| エリア: |
ID プロパティ |
注釈
このプロパティは、メッセージ コピーなどの関連オブジェクトのトレースを提供し、重複する受信者などの不要な出現箇所を見つけやすくします。
MAPI では、メッセージ受信者の検索キーを構築するための特定の規則が使用されます。 検索キーは、アドレスの種類 (大文字)、コロン文字 ':'、正規形式のメール アドレス、および終端の null 文字を連結して形成されます。 正規形式は、大文字と小文字が区別されるアドレスが正しい大文字と小文字で表示され、大文字と小文字が区別されないアドレスが大文字に変換されることを意味します。 これは、メッセージ間の相関関係を維持する上で重要です。
メッセージ オブジェクトの場合、このプロパティは、メッセージの作成直後に IMAPIProp::GetProps メソッドを使用して使用できます。 その他のオブジェクトの場合は、 IMAPIProp::SaveChanges メソッドの最初の呼び出しに続いて使用できます。 このプロパティは変更可能であるため、SaveChanges 呼び出しによって IMAPIProp::SetProps メソッドによって設定または変更された値がコミットされるまで、GetProps を介して取得することは信頼性が低い。
プロファイルの場合、MAPI では、 MUID_PROFILE_INSTANCE という名前のハードコーディングされたプロファイル セクションも提供され、このプロパティは 1 つのプロパティとして提供されます。 このキーは、これまでに作成したすべてのプロファイルで一意であることが保証され、同じ名前で削除して再作成するなど、 PR_PROFILE_NAME (PidTagProfileName) プロパティよりも信頼性が高くなります。
次の表は、 PR_ENTRYID (PidTagEntryId)、 PR_RECORD_KEY (PidTagRecordKey)、およびこのプロパティの重要な違いをまとめたものです。
| 特性 | PR_ENTRYID | PR_RECORD_KEY | PR_SEARCH_KEY |
|---|---|---|---|
| 添付ファイル オブジェクトで必須 |
不要 |
はい |
不要 |
| フォルダー オブジェクトで必須 |
はい |
はい |
不要 |
| メッセージ ストア オブジェクトで必須 |
はい |
はい |
不要 |
| 状態オブジェクトで必須 |
はい |
いいえ |
いいえ |
| クライアントによって作成可能 |
不要 |
いいえ |
はい |
| SaveChanges の前に使用可能 |
プロバイダーの実装によって異なります |
プロバイダーの実装によって異なります |
メッセージの場合は、はい。 その他の場合は、プロバイダーの実装に依存します。 |
| コピー操作で変更された |
はい |
はい |
いいえ |
| コピー後にクライアントによって変更可能 |
いいえ |
いいえ |
はい |
| ... 内で一意です。 | 全世界 |
プロバイダー インスタンス |
全世界 |
| バイナリ比較可能 (memcmp と同様) |
いいえ -- IMAPISupport::CompareEntryIDs を使用します |
はい |
はい |
関連リソース
プロトコル仕様
関連するExchange Serverプロトコル仕様への参照を提供します。
メッセージ オブジェクトと添付ファイル オブジェクトを処理します。
ユーザー、連絡先、グループ、リソースの一覧のプロパティと操作を指定します。
ヘッダー ファイル
Mapidefs.h
データ型の定義を提供します。
Mapitags.h
代替名として一覧表示されるプロパティの定義が含まれます。