PidTagSearchKey 標準プロパティPidTagSearchKey Canonical Property

適用対象: Outlook 2013 | Outlook 2016Applies to: Outlook 2013 | Outlook 2016

検索の相関オブジェクトを識別する2つの比較可能なキーが含まれています。Contains a binary-comparable key that identifies correlated objects for a search.

関連するプロパティ:Associated properties:
PR_SEARCH_KEYPR_SEARCH_KEY
識別子:Identifier:
0x300b0x300B
データの種類 : Data type:
PT_BINARYPT_BINARY
エリア:Area:
ID プロパティID properties

解説Remarks

このプロパティは、メッセージのコピーなどの関連オブジェクトのトレースを提供し、重複した受信者などの不必要な出現を検索しやすくします。This property provides a trace for related objects, such as message copies, and facilitates finding unwanted occurrences, such as duplicate recipients.

MAPI では、メッセージの受信者の検索キーを作成するための特定のルールを使用します。MAPI uses specific rules for constructing search keys for message recipients. 検索キーは、アドレスの種類 (大文字で表記)、コロン文字 ': '、標準形式の電子メールアドレス、および終端の null 文字を連結して形成されます。The search key is formed by concatenating the address type (in uppercase characters), the colon character ':', the email address in canonical form, and the terminating null character. ここでは、大文字と小文字が区別され、大文字と小文字が区別されないアドレスが大文字に変換されることを意味します。Canonical form here means that case-sensitive addresses appear in the correct case, and addresses that are not case-sensitive are converted to uppercase. これは、メッセージ間の相互関係を維持するために重要です。This is important in preserving correlations among messages.

message オブジェクトの場合、このプロパティは、メッセージの作成直後にimapiprop:: GetPropsメソッドを通じて使用できます。For message objects, this property is available through the IMAPIProp::GetProps method immediately following message creation. その他のオブジェクトの場合は、 imapiprop:: SaveChangesメソッドを最初に呼び出した後に使用できます。For other objects, it is available following the first call to the IMAPIProp::SaveChanges method. このプロパティは変更可能なので、 SaveChanges呼び出しがimapiprop:: setpropsメソッドによって設定または変更された値をコミットするまでは、 GetProps経由で取得することはできません。Because this property is changeable, it is unreliable to obtain it through GetProps until a SaveChanges call has committed any values set or changed by the IMAPIProp::SetProps method.

プロファイルの場合、MAPI は、 MUID_PROFILE_INSTANCEというハードコードされたプロファイルセクションを furnishes します。このプロパティは、このプロパティを単一のプロパティとして使用します。For profiles, MAPI also furnishes a hard-coded profile section named MUID_PROFILE_INSTANCE, with this property as its single property. このキーは、作成されたすべてのプロファイル間で一意であることが保証されており、 PR_PROFILE_NAME (PidTagProfileName) プロパティよりも信頼性が高くなることがあります。たとえば、削除されて同じ名前で再作成されます。This key is guaranteed to be unique among all profiles ever created, and can be more reliable than the PR_PROFILE_NAME (PidTagProfileName) property, which can be, for example, deleted and recreated with the same name.

次の表は、 PR_ENTRYID (PidTagEntryId)、 PR_RECORD_KEY (PidTagRecordKey)、およびこのプロパティの重要な相違点をまとめたものです。The following table summarizes important differences among the PR_ENTRYID (PidTagEntryId), PR_RECORD_KEY (PidTagRecordKey), and this property.

特性Characteristic PR_ENTRYID * * * *****PR_ENTRYID**** PR_RECORD_KEY * * * *****PR_RECORD_KEY**** PR_SEARCH_KEY * * * *****PR_SEARCH_KEY****
attachment オブジェクトに必要Required on attachment objects
いいえNo
はいYes
いいえNo
folder オブジェクトで必要Required on folder objects
はいYes
はいYes
いいえNo
メッセージストアオブジェクトに必要Required on message store objects
はいYes
はいYes
いいえNo
状態オブジェクトに必要ですRequired on status objects
はいYes
いいえNo
いいえNo
クライアントによるのが可能Creatable by client
いいえNo
いいえNo
はいYes
SaveChangesの前に使用可能Available before SaveChanges
プロバイダーの実装によって異なります。Depends on the provider implementation
プロバイダーの実装によって異なります。Depends on the provider implementation
メッセージの場合は、はい。For messages, Yes. その他の場合は、プロバイダーの実装によって異なります。For others, It depends on the provider implementation.
コピー操作で変更Changed in a copy operation
はいYes
はいYes
いいえNo
コピー後にクライアントによって変更可能Changeable by client after a copy
いいえNo
いいえNo
はいYes
一意の範囲Unique within ...
世界全体Entire world
プロバイダーインスタンスProvider instance
世界全体Entire world
二項比較 (memcmp と同じ)Binary comparable (as with memcmp)
No-- imapisupport:: compareentryidsを使用します。No -- use IMAPISupport::CompareEntryIDs
はいYes
はいYes

プロトコルの仕様Protocol specifications

[OXPROPS][MS-OXPROPS]

関連する Exchange Server プロトコル仕様への参照を提供します。Provides references to related Exchange Server protocol specifications.

[OXCMSG][MS-OXCMSG]

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

[OXOABK][MS-OXOABK]

ユーザー、連絡先、グループ、およびリソースのリストのプロパティと操作を指定します。Specifies the properties and operations for lists of users, contacts, groups, and resources.

ヘッダーファイルHeader files

mapidefs.hMapidefs.h

データ型定義を提供します。Provides data type definitions.

MapitagsMapitags.h

代替名としてリストされているプロパティの定義が含まれています。Contains definitions of properties listed as alternate names.

関連項目See also

PidTagResponsibility 標準プロパティPidTagResponsibility Canonical Property

PidTagStoreRecordKey 標準プロパティPidTagStoreRecordKey Canonical Property

MAPI のプロパティMAPI Properties

MAPI 標準プロパティMAPI Canonical Properties

標準プロパティ名から MAPI 名へのマッピングMapping Canonical Property Names to MAPI Names

MAPI 名から標準プロパティ名へのマッピングMapping MAPI Names to Canonical Property Names