Freigeben über

Primäre MAPI-Identität

  • Artikel

Gilt für: Outlook 2013 | Outlook 2016

Die meisten MAPI-Sitzungen verfügen über einen bestimmten Dienstanbieter, der die primäre Identität für die Sitzung bereitstellt. In der Regel handelt es sich um einen Adressbuchanbieter, der die Identität über eines seiner Messagingbenutzerobjekte oder Verteilerlisten bereitstellt. Tatsächlich empfiehlt MAPI, dass Nachrichtendienste, die einen Adressbuchanbieter enthalten, eines seiner Objekte für die primäre Identität verwenden. Wenn ein Dienstanbieter, der zu einem Nachrichtendienst gehört, die primäre Identität bereitstellt, teilen alle anderen Dienstanbieter im Nachrichtendienst diese Identität.

The MAPISVC. Die INF-Konfigurationsdatei enthält Einträge, die sich auf identitätsbezogener Ebene sowohl auf Nachrichtendienst- als auch auf Dienstanbieterebene beziehen. Nachrichtendienstabschnitte müssen einen Eintrag enthalten, der angibt, ob der Dienst die primäre Identität bereitstellen kann. Dienstanbieterabschnitte enthalten nur dann einen ähnlichen Eintrag, wenn der Anbieter eine Identität bereitstellen kann.

In der folgenden Tabelle sind die Einträge aufgeführt, die in den Abschnitten Nachrichtendienst und Dienstanbieter in MAPISVC angezeigt werden. INF-Datei.

Primärer Identitätsanbieter PR_RESOURCE_FLAGS Einstellung
Nachrichtendienst
 SERVICE_PRIMARY_IDENTITY
Nicht der Nachrichtendienst
 SERVICE_NO_PRIMARY_IDENTITY
Dienstleister
 STATUS_PRIMARY_IDENTITY

Obwohl mehrere Nachrichtendienste ihre Fähigkeit deklarieren können, die primäre Identität einer Sitzung bereitzustellen, ist dafür nur ein Nachrichtendienst ausgewählt. Diese Auswahl kann auftreten:

  • Wenn ein Profil erstellt wird.

  • Wenn ein Client IMsgServiceAdmin::SetPrimaryIdentity aufruft, um explizit einen bestimmten Nachrichtendienst als Anbieter der Sitzungsidentität einzurichten. Weitere Informationen. Siehe IMsgServiceAdmin::SetPrimaryIdentity.

Wenn ein Profil erstellt wird, bestimmt MAPI den ersten zu konfigurierenden Nachrichtendienst, der einen Anbieter enthält, dessen STATUS_PRIMARY_IDENTITY-Flag in seiner PR_RESOURCE_FLAGS-Eigenschaft (PidTagResourceFlags) festgelegt ist, um die primäre Identität anzugeben. Innerhalb des angegebenen Nachrichtendiensts wird der erste Anbieter, der mit diesem Ressourcenflag konfiguriert wird, ausgewählt, um die Identität für den Dienst bereitzustellen. Das STATUS_PRIMARY_IDENTITY-Flag wird für alle anderen Anbieter im angegebenen Dienst und für andere Nachrichtendienste im Profil deaktiviert. Wenn der Anbieter, der die primäre Identität bereitstellt, zu einem beliebigen Zeitpunkt aus dem Profil entfernt wird, weist MAPI die Rolle dem nächsten zu konfigurierenden Anbieter zu, der die Identität bereitstellen kann. Dies wird durch die Darstellung des PR_RESOURCE_FLAGS=STATUS_PRIMARY_IDENTITY Eintrags im Abschnitt des Anbieters in MAPISVC.INF bestimmt.

Wenn ein Client die IMsgServiceAdmin::SetPrimaryIdentity-Methode eines Nachrichtendiensts aufruft, gibt er die MAPIUID für einen Dienstanbieter innerhalb des Zieldiensts an. Weitere Informationen finden Sie unter MAPIUID. Der durch die MAPIUID dargestellte Dienstanbieter wird zugewiesen, um die primäre Identität für den Nachrichtendienst und für die Sitzung anzugeben, und alle anderen Anbieter im Dienst teilen diese Identität.

Jeder Anbieter im Nachrichtendienst, der für die Bereitstellung der primären Identität verantwortlich ist, aktualisiert seine Zeile in der status Tabelle, um die folgenden Eigenschaften einzuschließen.

Primäre Identitätseigenschaft Festgelegt auf
PR_IDENTITY_DISPLAY (PidTagIdentityDisplay)
 Anzeigename des Objekts, das die primäre Identität angibt.
PR_IDENTITY_SEARCH_KEY (PidTagIdentitySearchKey)
 Suchschlüssel für das Objekt, das die primäre Identität angibt.
PR_IDENTITY_ENTRYID (PidTagIdentityEntryId)
 Eintragsbezeichner für das Objekt, das die primäre Identität angibt.

So rufen Sie den Eintragsbezeichner für das Objekt ab, das die primäre Identität angibt

  • Rufen Sie die IMAPISession::QueryIdentity-Methode auf . Weitere Informationen finden Sie unter IMAPISession::QueryIdentity. QueryIdentity durchsucht die status Tabelle nach der Zeile, die den Wert STATUS_PRIMARY_IDENTITY in der PR_RESOURCE_FLAGS Spalte enthält, und gibt den entsprechenden PR_IDENTITY_ENTRYID als Eintragsbezeichner für die primäre Identität zurück.