通过

Office.MailboxEnums.TokenStatus enum

包:
outlook

注意

此 API 以预览状态提供给开发者，可能根据我们收到的反馈更改。 请勿在生产环境中使用此 API。

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

注解

[ API 集：邮箱预览 ]

适用的 Outlook 模式：Compose或读取

重要提示：旧版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/99-preview-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

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