GetDelegate-Vorgang

  • Artikel

Der GetDelegate-Vorgang ruft die Delegateinstellungen für ein angegebenes Postfach ab.

SOAP-Header

Der GetDelegate-Vorgang kann die SOAP-Header verwenden, die in der folgenden Tabelle aufgeführt und beschrieben werden.

Header Element Beschreibung
Identitätswechsel
 ExchangeImpersonation
Identifiziert den Benutzer, für den die Clientanwendung einen Identitätswechsel durchführt.
MailboxCulture
 MailboxCulture
Gibt die RFC3066-Kultur an, die für den Zugriff auf das Postfach verwendet wird.
RequestVersion
 RequestServerVersion
Gibt die Schemaversion für die Vorgangsanforderung an.
ServerVersion
 ServerVersionInfo
Gibt die Version des Servers an, der auf die Anforderung geantwortet hat.

GetDelegate-Anforderungsbeispiel

Beschreibung

Im folgenden Codebeispiel wird gezeigt, wie die Delegateinstellungen für alle Delegaten abgerufen werden, die für das Postfach von User3 festgelegt sind. Alle Berechtigungen für jeden Benutzer werden in der Antwort zurückgegeben.

Code

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Header>
    <t:RequestServerVersion Version="Exchange2007_SP1"/>
  </soap:Header>
  <soap:Body>
    <GetDelegate xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
                 xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
                 IncludePermissions="true">
      <Mailbox>
        <t:EmailAddress>user3@example.com</t:EmailAddress>
      </Mailbox>
    </GetDelegate>
  </soap:Body>
</soap:Envelope>

Kommentare

Sie können das UserId-Element verwenden, um einzelne Benutzer anzugeben, anstatt alle Benutzer zurückzugeben, die über Stellvertretungsberechtigungen für das Postfach verfügen.

Hinweis

Exchange-Webdienste (EWS) unterstützen die Verwaltung von Gruppendelegaten nicht. EWS gibt einen Fehler zurück, wenn der GetDelegate-Vorgang für einen Prinzipal aufgerufen wird, der über einen Sicherheitsgruppendelegat verfügt.

GetDelegate-Antwortbeispiel

Beschreibung

Das folgende Beispiel einer GetDelegate-Antwort zeigt eine erfolgreiche Antwort auf eine GetDelegate-Anforderung . Die Antwort enthält Informationen zu den Zugriffsberechtigungen für Stellvertretungen, ob der Delegat private Elemente anzeigen kann, ob der Delegat Kopien von Besprechungsnachrichten empfängt und an wen Besprechungsanfragen übermittelt wurden.

Code

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" 
                         MinorVersion="1" 
                         MajorBuildNumber="206" 
                         MinorBuildNumber="0" 
                         Version="Exchange2007_SP1" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <m:GetDelegateResponse xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                           ResponseClass="Success" 
                           xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseCode>NoError</m:ResponseCode>
      <m:ResponseMessages>
        <m:DelegateUserResponseMessageType ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:DelegateUser>
              <t:UserId>
                <t:SID>S-1-5-21-1333220396-2200287332-232816053-1116</t:SID>
                <t:PrimarySmtpAddress>User1@example.com</t:PrimarySmtpAddress>
                <t:DisplayName>User1</t:DisplayName>
              </t:UserId>
              <t:DelegatePermissions>
                <t:CalendarFolderPermissionLevel>Author</t:CalendarFolderPermissionLevel>
                <t:ContactsFolderPermissionLevel>Reviewer</t:ContactsFolderPermissionLevel>
              </t:DelegatePermissions>
              <t:ReceiveCopiesOfMeetingMessages>false</t:ReceiveCopiesOfMeetingMessages>
            <t:ViewPrivateItems>false</t:ViewPrivateItems>
            </m:DelegateUser>
          </m:DelegateUserResponseMessageType>
      </m:ResponseMessages>
      <m:DeliverMeetingRequests>DelegatesAndMe</m:DeliverMeetingRequests>
      </m:GetDelegateResponse>
  </soap:Body>
</soap:Envelope>

Siehe auch