IMsgServiceAdmin::SetPrimaryIdentity
Gilt für: Outlook 2013 | Outlook 2016
Legt einen Nachrichtendienst als Lieferanten der primären Identität für das Profil fest.
HRESULT SetPrimaryIdentity(
LPMAPIUID lpUID,
ULONG ulFlags
);
Parameter
lpUID
[in] Ein Zeiger auf die MAPIUID-Struktur , die den eindeutigen Bezeichner für den Nachrichtendienst zum Bereitstellen der primären Identität enthält, oder NULL, der angibt, dass SetPrimaryIdentity die aktuelle Identität löschen soll.
ulFlags
[in] Reserviert. NULL muss sein.
Rückgabewert
S_OK
Dem Nachrichtendienst wurde erfolgreich der Lieferant der primären Identität zugewiesen.
MAPI_E_NO_ACCESS
SetPrimaryIdentity hat versucht, einen Nachrichtendienst zu bestimmen, für den das SERVICE_NO_PRIMARY_IDENTITY-Flag in seiner PR_RESOURCE_FLAGS -Eigenschaft (PidTagResourceFlags) festgelegt ist.
Hinweise
Die IMsgServiceAdmin::SetPrimaryIdentity-Methode richtet einen Nachrichtendienst als Anbieter der primären Identität für das Profil ein. Die primäre Identität ist in der Regel der Benutzer, der beim Nachrichtendienst angemeldet ist. Sie wird durch drei Eigenschaften dargestellt:
PR_IDENTITY_DISPLAY (PidTagIdentityDisplay)
PR_IDENTITY_ENTRYID (PidTagIdentityEntryId)
PR_IDENTITY_SEARCH_KEY (PidTagIdentitySearchKey)
Jeder Dienstanbieter im angegebenen Nachrichtendienst legt diese drei Eigenschaften auf den Anzeigenamen, den Eintragsbezeichner und den Suchschlüssel des Messagingbenutzers fest, der die primäre Identität bereitstellt. Clients können den Eintragsbezeichner der primären Identität abrufen, indem sie die IMAPISession::QueryIdentity-Methode aufrufen.
Die eigenschaft PR_RESOURCE_FLAGS wird für jeden Anbieter, der Mitglied des Nachrichtendiensts ist, der die primäre Identität bereitstellt, auf STATUS_PRIMARY_IDENTITY und auf SERVICE_PRIMARY_IDENTITY für den Nachrichtendienst festgelegt. Wenn ein Dienstanbieter die primäre Identität für seinen Nachrichtendienst nicht bereitstellen kann, legt er PR_RESOURCE_FLAGS auf STATUS_NO_PRIMARY_IDENTITY fest. SetPrimaryIdentity legt die PR_RESOURCE_FLAGS-Eigenschaft jedes Nachrichtendiensts fest, der die primäre Identität nicht an SERVICE_NO_PRIMARY_IDENTITY bereitstellt.
Jeder Nachrichtendienstanbieter, zu dem MAPI Über Informationen verfügt, kann eine Identität für jeden seiner Benutzer einrichten, wenn sich ein Client beim Dienst anmeldet. Da MAPI jedoch Verbindungen mit mehreren Dienstanbietern für jede MAPI-Sitzung unterstützt, gibt es keine feste Definition der Identität eines bestimmten Benutzers für die MAPI-Sitzung als Ganzes. Die Identität eines Benutzers hängt davon ab, welcher Dienst beteiligt ist. Clients können SetPrimaryIdentity aufrufen, um eine der vielen Identitäten festzulegen, die von Nachrichtendiensten für einen Benutzer als primäre Identität für diesen Benutzer eingerichtet wurden.