Office.MailboxEnums.TokenStatus enum

指定组织中 Exchange Web 服务 (EWS) 回调令牌或 REST API 令牌的状态。

注解

API 集:邮箱 1.16

适用的 Outlook 模式:Compose 或 Read

重要提示:不再支持旧版 Exchange Online 用户标识令牌和回调令牌,并在所有 Microsoft 365 租户中将其关闭。 如果 Outlook 加载项需要委派的用户访问权限或用户标识,建议使用 MSAL (Microsoft 身份验证库) 和嵌套应用身份验证 (NAA) 。 Exchange 内部部署仍支持 Exchange 用户标识令牌。 有关详细信息,请参阅 嵌套应用身份验证常见问题解答。

使用方

示例

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/89-other-mailbox-apis/get-token-status.yaml

Office.context.mailbox.diagnostics.ews.getTokenStatusAsync({ isRest: false }, (result) => {
  if (result.status === Office.AsyncResultStatus.Failed) {
    console.log(result.error.message);
    return;
  }
  const status = result.value;
  switch (status) {
    case Office.MailboxEnums.TokenStatus.Enabled:
      console.log("EWS callback tokens are enabled.");
      break;
    case Office.MailboxEnums.TokenStatus.Disabled:
      console.log("EWS callback tokens are disabled.");
      break;
    case Office.MailboxEnums.TokenStatus.Removed:
      console.log("The organization has an Exchange Online environment. Legacy Exchange tokens are no longer supported.");
      break;
  }
});

字段

Disabled = 0

EWS 回调令牌或 REST API 令牌在组织中关闭。

Enabled = 1

组织支持 EWS 回调令牌或 REST API 令牌。

Removed = 2

邮箱托管在 Exchange Online 环境中,其中 EWS 令牌已关闭且不再受支持。