Freigeben über


PidTagSearchKey (kanonische Eigenschaft)

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

Protokollspezifikationen

[MS-OXPROPS]

Stellt Verweise auf verwandte Exchange Server Protokollspezifikationen bereit.

[MS-OXCMSG]

Verarbeitet Nachrichten- und Anlageobjekte.

[MS-OXOABK]

Gibt die Eigenschaften und Vorgänge für Listen von Benutzern, Kontakten, Gruppen und Ressourcen an.

Headerdateien

Mapidefs.h

Stellt Datentypdefinitionen bereit.

Mapitags.h

Enthält Definitionen von Eigenschaften, die als alternative Namen aufgeführt sind.

Siehe auch

PidTagResponsibility (kanonische Eigenschaft)

PidTagStoreRecordKey (kanonische Eigenschaft)

MAPI-Eigenschaften

MAPI (kanonische Eigenschaften)

Zuordnen kanonischer Eigenschaftennamen zu MAPI-Namen

Zuordnen von MAPI-Namen zu kanonischen Eigenschaftennamen