PidTagSearchKey (kanonische Eigenschaft)

Artikel
04/04/2023

Gilt für: Outlook 2013 | Outlook 2016

Enthält einen binär vergleichbaren Schlüssel, der korrelierte Objekte für eine Suche identifiziert.

Eigenschaft	Wert
Zugeordnete Eigenschaften:	PR_SEARCH_KEY
Kennung:	0x300B
Datentyp:	PT_BINARY
Bereich:	ID-Eigenschaften

Hinweise

Diese Eigenschaft stellt eine Ablaufverfolgung für verwandte Objekte bereit, z. B. Nachrichtenkopien, und erleichtert die Suche nach unerwünschten Vorkommen, z. B. doppelten Empfängern.

MAPI verwendet bestimmte Regeln zum Erstellen von Suchschlüsseln für Nachrichtenempfänger. Der Suchschlüssel wird gebildet, indem der Adresstyp (in Großbuchstaben), das Doppelpunktzeichen ":", die E-Mail-Adresse in kanonischer Form und das abschließende NULL-Zeichen verkettet werden. Kanonische Form bedeutet hier, dass Adressen, bei denen Groß-/Kleinschreibung beachtet wird, in der richtigen Groß-/Kleinschreibung angezeigt werden und Adressen, bei denen die Groß-/Kleinschreibung nicht beachtet wird, in Großbuchstaben konvertiert werden. Dies ist wichtig, um Korrelationen zwischen Nachrichten aufrechtzuerhalten.

Für Nachrichtenobjekte ist diese Eigenschaft über die IMAPIProp::GetProps-Methode unmittelbar nach der Nachrichtenerstellung verfügbar. Für andere Objekte ist sie nach dem ersten Aufruf der IMAPIProp::SaveChanges-Methode verfügbar. Da diese Eigenschaft änderbar ist, ist es unzuverlässig, sie über GetProps abzurufen, bis ein SaveChanges-Aufruf ein Commit für werte ausgeführt hat, die von der IMAPIProp::SetProps-Methode festgelegt oder geändert wurden.

Für Profile stellt MAPI auch einen hartcodierten Profilabschnitt namens MUID_PROFILE_INSTANCE mit dieser Eigenschaft als einzelne Eigenschaft bereit. Dieser Schlüssel ist unter allen jemals erstellten Profilen garantiert eindeutig und kann zuverlässiger sein als die eigenschaft PR_PROFILE_NAME (PidTagProfileName), die beispielsweise gelöscht und mit demselben Namen neu erstellt werden kann.

In der folgenden Tabelle sind wichtige Unterschiede zwischen den PR_ENTRYID (PidTagEntryId), PR_RECORD_KEY (PidTagRecordKey) und dieser Eigenschaft zusammengefasst.

Merkmal	PR_ENTRYID	PR_RECORD_KEY	PR_SEARCH_KEY
Erforderlich für Anlagenobjekte	Nein	Ja	Nein
Erforderlich für Ordnerobjekte	Ja	Ja	Nein
Erforderlich für Nachrichtenspeicherobjekte	Ja	Ja	Nein
Erforderlich für status-Objekte	Ja	Nein	Nein
Erstellbar nach Client	Nein	Nein	Ja
Verfügbar vor SaveChanges	Abhängig von der Anbieterimplementierung	Abhängig von der Anbieterimplementierung	Für Nachrichten: Ja. Bei anderen hängt dies von der Anbieterimplementierung ab.
In einem Kopiervorgang geändert	Ja	Ja	Nein
Änderbar vom Client nach einer Kopie	Nein	Nein	Ja
Einzigartig in ...	Ganze Welt	anbieter instance	Ganze Welt
Binär vergleichbar (wie bei memcmp)	Nein – verwenden Sie IMAPISupport::CompareEntryIDs.	Ja	Ja