PidTagSearchKey Canonical 屬性
適用於：Outlook 2013 |Outlook 2016
包含可識別搜尋之相互關聯物件的二進位可比較索引鍵。
| 屬性 | 值 |
|---|---|
| 相關聯的屬性： |
PR_SEARCH_KEY |
| 識別碼： |
0x300B |
| 資料類型： |
PT_BINARY |
| 地區： |
標識碼屬性 |
註解
這個屬性會提供相關對象的追蹤，例如訊息複本，並有助於尋找不必要的專案，例如重複的收件者。
MAPI 會使用特定規則來建構郵件收件者的搜尋密鑰。 搜尋索引鍵的構成方式是將位址類型串連 (大寫字元) 、冒號字元 '：'、標準格式的電子郵件位址，以及終止的 Null 字元。 這裡的標準形式表示區分大小寫的位址會出現在正確的案例中，而不區分大小寫的位址會轉換成大寫。 這對於保留訊息之間的相互關聯很重要。
針對訊息物件，此屬性可在訊息建立後立即透過 IMAPIProp：：GetProps 方法取得。 對於其他物件，它可在第一次呼叫 IMAPIProp：：SaveChanges 方法之後使用。 因為這個屬性是可變更的，所以除非SaveChanges呼叫認可IMAPIProp：：SetProps方法所設定或變更的任何值，否則無法透過 GetProps 取得它。
針對配置檔，MAPI 也會提供名為 MUID_PROFILE_INSTANCE 的硬式編碼配置檔區段，並以此屬性作為其單一屬性。 此密鑰保證在所有建立的配置檔中都是唯一的，而且可以比 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
包含列為替代名稱的屬性定義。
另請參閱
PidTagResponsibility Canonical 屬性