GetDelegate 操作

项目
03/29/2023

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>

另请参阅

Exchange 中的 EWS XML 元素

通过