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 を使用します
はい
 はい

プロトコル仕様

[MS-OXPROPS]

関連するExchange Serverプロトコル仕様への参照を提供します。

[MS-OXCMSG]

メッセージ オブジェクトと添付ファイル オブジェクトを処理します。

[MS-OXOABK]

ユーザー、連絡先、グループ、リソースの一覧のプロパティと操作を指定します。

ヘッダー ファイル

Mapidefs.h

データ型の定義を提供します。

Mapitags.h

代替名として一覧表示されるプロパティの定義が含まれます。

関連項目

MAPI のプロパティ

MAPI 標準プロパティ

MAPI 名への標準プロパティ名のマッピング

MAPI 名を正規のプロパティ名にマッピングする