GetUserOofSettings-Vorgang

  • Artikel

Der Vorgang GetUserOofSettings ruft die Abwesenheitseinstellungen und Nachrichten eines Postfachbenutzers ab.

SOAP-Header

Der GetUserOofSettings-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.
ServerVersion
 ServerVersionInfo
Gibt die Version des Servers an, der auf die Anforderung geantwortet hat.

Verwenden des GetUserOofSettings-Vorgangs

Der GetUserOofSettings-Vorgang bietet Zugriff auf die OOF-Einstellungen eines Benutzers. Ein Benutzer wird durch die E-Mail-Adresse des Benutzers identifiziert. Wenn die OOF-Nachricht NULL ist und OOF aktiviert ist, wird keine OOF-Nachricht gesendet.

Wichtig

Wenn die OOF-Nachrichten von MicrosoftOfficeOutlook festgelegt werden, gibt dieser Vorgang die OOF-Nachrichten im HTML-Format zurück.

GetUserOofSettings-Anforderungsbeispiel

Beschreibung

Das folgende Beispiel zeigt eine GetUserOofSettings-Anforderung , die die OOF-Informationen eines einzelnen Benutzers abruft.

Code

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetUserOofSettingsRequest xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <Mailbox xmlns ="https://schemas.microsoft.com/exchange/services/2006/types">
        <Address>User1@example.com</Address>
      </Mailbox>
    </GetUserOofSettingsRequest>
  </soap:Body>
</soap:Envelope>

Anfordern von Elementen

In der Anforderung werden folgende Elemente verwendet:

Beispiel für eine erfolgreiche GetUserOofSettings-Antwort

Beschreibung

Das folgende Beispiel zeigt einen deaktivierten OOF-Zustand mit den OOF-Nachrichten.

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="0" MajorBuildNumber="685" MinorBuildNumber="8" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <GetUserOofSettingsResponse xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseMessage ResponseClass="Success">
        <ResponseCode>NoError</ResponseCode>
      </ResponseMessage>
      <OofSettings xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
        <OofState>Disabled</OofState>
        <ExternalAudience>All</ExternalAudience>
        <Duration>
          <StartTime>2006-11-03T23:00:00</StartTime>
          <EndTime>2006-11-04T23:00:00</EndTime>
        </Duration>
        <InternalReply>
          <Message>I am out of office. This is my internal reply.</Message>
        </InternalReply>
        <ExternalReply>
          <Message>I am out of office. This is my external reply.</Message>
        </ExternalReply>
      </OofSettings>
      <AllowExternalOof>All</AllowExternalOof>
    </GetUserOofSettingsResponse>
  </soap:Body>
</soap:Envelope>

Erfolgreiche GetUserOofSettings-Antwortelemente

In der Antwort werden folgende Elemente verwendet:

GetUserOofSettings-Fehlerantwortbeispiel

Beschreibung

Das folgende Beispiel zeigt eine Fehlerantwort, die durch den Versuch verursacht wird, auf die OOF-Informationen eines anderen Benutzers zuzugreifen.

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="0" MajorBuildNumber="685" MinorBuildNumber="8" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <soap:Fault>
      <faultcode>soap:Client</faultcode>
      <faultstring>Microsoft.Exchange.Data.Storage.AccessDeniedException: User is not mailbox owner. User = S-1-5-21-3642464542-282065186-3871681729-1155, MailboxGuid = S-1-5-21-3642464542-282065186-3871681729-1156 ---> User is not mailbox owner. </faultstring>
      <faultactor>https://CAS01.example.com/EWS/Exchange.asmx</faultactor>
      <detail>
        <ErrorCode xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">-2146233088</ErrorCode>
      </detail>
    </soap:Fault>
  </soap:Body>
</soap:Envelope>

Siehe auch