PidTagRecordKey 標準プロパティ
適用対象: Outlook 2013 | Outlook 2016
特定のオブジェクトの一意のバイナリ対応識別子が含まれます。
プロパティ | 値 |
---|---|
関連するプロパティ: |
PR_RECORD_KEY |
識別子: |
0x0FF9 |
データの種類 : |
PT_BINARY |
エリア: |
ID プロパティ |
注釈
このプロパティは、コンテンツ テーブル内の行の検索など、オブジェクトへの参照の検索を容易にします。 このプロパティを使用してオブジェクトを開くことはできません。その目的のためにエントリ識別子を使用します。
添付ファイルのサブオブジェクトは、このプロパティによってメッセージ内で一意に識別する必要があります。 この識別子は、メッセージを閉じて再度開いた後も同じ状態を維持することが保証される唯一の添付ファイル特性です。 ストア プロバイダーは、この保証を保証するために、セッション間でこのプロパティを保持する必要があります。
フォルダーの場合、このプロパティにはフォルダー階層テーブルで使用されるキーが含まれます。 通常、これは PR_ENTRYID (PidTagEntryId) プロパティによって提供される値と同じです。
メッセージ ストアの場合、このプロパティは PR_STORE_RECORD_KEY (PidTagStoreRecordKey) プロパティと同じです。
メッセージ ストア オブジェクトでは、このプロパティはすべてのストア プロバイダーで一意である必要があります。 これを行う方法の 1 つは、ストアの PR_MDB_PROVIDER (PidTagStoreProvider) プロパティ (そのプロバイダーの種類に固有) の値と、特定のメッセージ ストアに固有の GUID 構造体またはその他の値を組み合わせることです。
このプロパティは、 IMAPIProp:: SaveChanges メソッドの最初の呼び出しに続く IMAPIProp::GetProps メソッドを通じて常に使用できます。 一部のプロバイダーでは、インスタンス化の直後に使用可能にすることができます。
クライアントまたはサービス プロバイダーは、memcmp を使用して、このプロパティの値を比較できます。 これは、エントリ識別子の値には使用できません。 ただし、このプロパティは、同じメッセージ ストアまたはアドレス帳コンテナー内で一意であることが保証されます。異なるコンテナーの 2 つのオブジェクトは、このプロパティの同じ値を持つことができます。
レコードキーと検索キーの違いの 1 つは、レコード キーがオブジェクトに固有であるのに対し、検索キーは他のオブジェクトにコピーできることです。 たとえば、オブジェクトの 2 つのコピーは同じ PR_SEARCH_KEY (PidTagSearchKey) 値を持つことができますが、このプロパティの値は異なる必要があります。
次の表は、 PR_ENTRYID、 PR_SEARCH_KEY (PidTagSearchKey) とこのプロパティの重要な違いをまとめたものです。
特性 | PR_ENTRYID | PR_RECORD_KEY | PR_SEARCH_KEY |
---|---|---|---|
添付ファイル オブジェクトで必須 |
不要 |
はい |
不要 |
フォルダー オブジェクトで必須 |
はい |
はい |
いいえ |
メッセージ ストア オブジェクトで必須 |
はい |
はい |
いいえ |
状態オブジェクトで必須 |
はい |
いいえ |
いいえ |
クライアントによって作成可能 |
いいえ |
いいえ |
はい |
SaveChanges の呼び出しの前に使用できます |
多分 |
多分 |
メッセージ あり その他 |
コピー操作で変更された |
はい |
はい |
いいえ |
コピー後にクライアントによって変更可能 |
不要 |
不要 |
はい |
... 内で一意です。 | 全世界 |
プロバイダー インスタンス |
全世界 |
バイナリ比較可能 (memcmp と同様) |
いいえ -- IMAPISupport:: CompareEntryIDs を使用します |
はい |
はい |
関連リソース
プロトコル仕様
関連するExchange Serverプロトコル仕様への参照を提供します。
メッセージ オブジェクトと添付ファイル オブジェクトを処理します。
ユーザー、連絡先、グループ、リソースの一覧のプロパティと操作を指定します。
ヘッダー ファイル
Mapidefs.h
データ型の定義を提供します。
Mapitags.h
代替名として一覧表示されるプロパティの定義が含まれます。