RemoveDelegate 操作RemoveDelegate operation

• 09/17/2015
• • o

RemoveDelegate操作将从用户的邮箱中删除一个或多个代理。The RemoveDelegate operation removes one or more delegates from a user's mailbox.

SOAP 标头SOAP Headers

RemoveDelegate操作可以使用下表中列出和描述的 SOAP 标头。The RemoveDelegate operation can use the SOAP headers that are listed and described in the following table.

RemoveDelegate 请求示例RemoveDelegate request example

DescriptionDescription

下面的代码示例演示如何从 user1's 邮箱中删除两个代理。The following code example shows how to remove two delegates from user1's mailbox. 在此示例中，将使用代理的主 SMTP 地址删除一个委派，并使用代理的安全标识符（SID）删除另一个委派。In this example, one delegate is removed by using the delegate's primary SMTP address, and the other one is removed by using the delegate's security identifier (SID).

代码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>
    <RemoveDelegate xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
                    xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
      <Mailbox>
        <t:EmailAddress>user1@example.com</t:EmailAddress>
      </Mailbox>
      <UserIds>
        <t:UserId>
          <t:PrimarySmtpAddress>user2@example.com</t:PrimarySmtpAddress>
        </t:UserId>
        <t:UserId>
          <t:SID>S-1-5-21-1333220396-2200287332-232816053-1118</t:SID>
        </t:UserId>
      </UserIds>
    </RemoveDelegate>
  </soap:Body>
</soap:Envelope>

备注Comments

RemoveDelegate操作不要求指定的代理用户拥有邮箱或存在于 Active Directory 目录服务中。The RemoveDelegate operation does not require the specified delegate user to have a mailbox or to exist in the Active Directory directory service. 如果委派条目是孤立的， RemoveDelegate操作将会成功。The RemoveDelegate operation will succeed if the delegate entry is orphaned.

RemoveDelegate 响应示例RemoveDelegate response example

DescriptionDescription

下面的RemoveDelegate响应示例显示了对RemoveDelegate请求的成功响应。The following example of a RemoveDelegate response shows a successful response to a RemoveDelegate request. 响应包含从邮箱中删除的每个代理的DelegateUserResponseMessageType元素。The response contains a DelegateUserResponseMessageType element for each delegate that is removed from the mailbox.

代码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:RemoveDelegateResponse 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:DelegateUserResponseMessageType>
        <m:DelegateUserResponseMessageType ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
        </m:DelegateUserResponseMessageType>
      </m:ResponseMessages>
      </m:RemoveDelegateResponse>
  </soap:Body>
</soap:Envelope>

RemoveDelegate 错误响应示例RemoveDelegate Error response example

DescriptionDescription

下面的RemoveDelegate错误响应示例显示请求删除不存在的代理的结果。The following example of a RemoveDelegate error response shows the results of a request to remove a delegate that does not exist.

代码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:RemoveDelegateResponse 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="Error">
          <m:MessageText>The user is not a delegate for the mailbox.</m:MessageText>
          <m:ResponseCode>ErrorNotDelegate</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
        </m:DelegateUserResponseMessageType>
      </m:ResponseMessages>
    </m:RemoveDelegateResponse>
  </soap:Body>
</soap:Envelope>

另请参阅See also

• Exchange 中的 EWS XML 元素EWS XML elements in Exchange