GetDelegate 操作

  • [アーティクル]

GetDelegate 操作は、指定したメールボックスのデリゲート設定を取得します。

SOAP ヘッダー

GetDelegate 操作では、次の表に記載されている SOAP ヘッダーを使用できます。

Header 要素 説明
偽装
 ExchangeImpersonation
クライアント アプリケーションが偽装しているユーザーを識別します。
MailboxCulture
 MailboxCulture
メールボックスへのアクセスに使用する RFC3066 カルチャを識別します。
RequestVersion
 RequestServerVersion
操作要求のスキーマ バージョンを識別します。
ServerVersion
 ServerVersionInfo
要求に応答したサーバーのバージョンを識別します。

GetDelegate 要求の例

説明

次のコード例は、user3 のメールボックスに設定されているすべてのデリゲートのデリゲート設定を取得する方法を示しています。 各ユーザーのすべてのアクセス許可が応答で返されます。

コード

<?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>

Comments

UserId 要素を使用すると、メールボックスに対する代理人アクセス許可を持つすべてのユーザーを返す代わりに、個々のユーザーを指定できます。

注:

Exchange Web Services (EWS) では、グループ デリゲートの管理はサポートされていません。 セキュリティ グループ デリゲートを持つプリンシパルに対して GetDelegate 操作が呼び出された場合、EWS はエラーを返します。

GetDelegate 応答の例

説明

GetDelegate 応答の次の例は、GetDelegate 要求に対する成功した応答を示しています。 応答には、代理人のアクセス許可、代理人がプライベートアイテムを表示できるかどうか、代理人が会議メッセージのコピーを受け取るかどうか、および会議出席依頼が配信されたユーザーに関する情報が含まれます。

コード

<?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>

関連項目