PerformReminderAction 操作

项目
03/29/2023

查找有关 PerformReminderAction EWS 操作的信息。

PerformReminderAction Exchange Web Services (EWS) 操作在提醒时启动关闭或推迟操作。

Exchange Server 2013 中引入了此操作。

使用 PerformReminderAction 操作

可以使用 PerformReminderAction 操作消除或推迟 (延迟 GetReminders 操作返回) 提醒。若要暂停提醒，请将 ActionType 设置为 “暂停”，并将 NewReminderTime 值设置为比当前 ReminderTime 晚一段时间，否则服务器将忽略 NewReminderTime 。如果提醒是针对定期会议的发生，并且对提醒采取了暂停 操作， 而 NewReminderTime 已超过下一个事件的提醒，则实际上会消除该提醒。

若要消除提醒，请将 ActionType 设置为 “消除”。当服务器处理请求时，服务器会将该项的 IsReminderSet 值从 True 更改为 False。

PerformReminderAction 操作 SOAP 标头

PerformReminderAction 操作可以使用下表中列出的 SOAP 标头。

标头名称	元素	说明
模拟	ExchangeImpersonation	标识客户端应用程序正在模拟的用户。此标头适用于请求。
MailboxCulture	MailboxCulture	标识要用于访问邮箱的区域性，如 RFC 3066“标识语言标记”中所述。此标头适用于请求。
RequestVersion	RequestServerVersion	标识操作请求的架构版本。此标头适用于请求。
ServerVersion	ServerVersionInfo	标识响应请求的服务器版本。此标头适用于响应。

PerformReminderAction 操作请求示例

以下示例的 PerformReminderAction 操作请求演示如何暂停当前提醒并设置新的提醒时间。请注意，需要包含 ItemId 的 ChangeKey，并且 NewReminderTime 必须设置为晚于 GetReminders 操作返回的 ReminderTime 的时间。

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
               xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <t:RequestServerVersion Version="Exchange2013" />
  </soap:Header>
  <soap:Body>
    <m:PerformReminderAction>
      <m:ReminderItemActions>
        <t:ReminderItemAction>
          <t:ActionType>Snooze</t:ActionType>
          <t:ItemId Id="vwAAAA=="
           ChangeKey="DwAAABQAAACOs0HEMq1WTKpI7sNu5qXNAAAUDA=="/>
          <t:NewReminderTime>2014-04-16T17:00:00Z</t:NewReminderTime>
        </t:ReminderItemAction>
      </m:ReminderItemActions>
    </m:PerformReminderAction>
  </soap:Body>
</soap:Envelope>

注意

已缩短 ItemId 值以保持可读性。

请求 SOAP 正文包含以下元素：

成功执行ReminderAction 操作响应

以下示例显示了 对 PerformReminderAction 操作请求的成功响应。 UpdatedItemIds 元素包含更新的日历项目的 ItemIds。

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <ServerVersionInfo MajorVersion="15"
                       MinorVersion="0"
                       MajorBuildNumber="921"
                       MinorBuildNumber="20"
                       Version="V2_10"
                       xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" />
  </s:Header>
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <PerformReminderActionResponse ResponseClass="Success"
                                   xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseCode>NoError</ResponseCode>
      <UpdatedItemIds>
        <ItemId Id="vwAAAA=="
                ChangeKey="DwAAABYAAAB4to43JyybTYwHLBM1k8MxAAAJKP+S"/>
      </UpdatedItemIds>
    </PerformReminderActionResponse>
  </s:Body>
</s:Envelope>

响应 SOAP 正文包含以下元素：

PerformReminderAction 操作错误响应示例

以下示例演示了在服务器上未进行更改时 对 PerformReminderAction 操作请求的响应。这是一个响应，其中发送了请求，但未返回 UpdatedItemIds ，这意味着没有更改提醒。

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <ServerVersionInfo MajorVersion="15"
                       MinorVersion="0"
                       MajorBuildNumber="918"
                       MinorBuildNumber="7"
                       Version="V2_10"
                       xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" />
  </s:Header>
  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <PerformReminderActionResponse ResponseClass="Success"
                                   xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseCode>NoError</ResponseCode>
      <UpdatedItemIds />
    </PerformReminderActionResponse>
  </s:Body>
</s:Envelope>

错误响应 SOAP 正文包含以下元素：

有关 EWS 通用的其他错误代码，请参阅 ResponseCode。

另请参阅

GetReminders 操作

通过