Office.Ews interface

Paket:
outlook

Stellt Methoden bereit, um zu ermitteln, ob Exchange-Webdienste (EWS)-Rückruftoken in einer organization unterstützt werden.

Hinweise

API-Satz: Postfach 1.16

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Compose oder Lesen

Wichtig: Legacy-Benutzeridentitätstoken und Rückruftoken von Exchange Online werden nicht mehr unterstützt und sind für alle Microsoft 365-Mandanten deaktiviert. Wenn ein Outlook-Add-In delegierten Benutzerzugriff oder Benutzeridentität erfordert, empfehlen wir die Verwendung von MSAL (Microsoft Authentication Library (MSAL)) und der geschachtelten App-Authentifizierung (NAA). Exchange-Benutzeridentitätstoken werden für Exchange lokal weiterhin unterstützt. Weitere Informationen finden Sie unter Häufig gestellte Fragen zur Authentifizierung geschachtelter Apps.

Verwendet von

Beispiele

// 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;
  }
});

Methoden

getTokenStatusAsync(options, callback)

Ruft den Status von EWS-Rückruftoken in einer organization ab.
getTokenStatusAsync(callback)

Ruft den Status von EWS-Rückruftoken in einer organization ab.

Details zur Methode

getTokenStatusAsync(options, callback)

Ruft den Status von EWS-Rückruftoken in einer organization ab.

getTokenStatusAsync(options: Office.AsyncContextOptions & { isRest?: boolean }, callback: (asyncResult: Office.AsyncResult<MailboxEnums.TokenStatus>) => void): void;

Parameter

options

Office.AsyncContextOptions & { isRest?: boolean }

Ein Objektliteral, das mindestens eine der folgenden Eigenschaften enthält. asyncContext : Alle Daten, auf die Sie in der Rückruffunktion zugreifen möchten. isRest : Gibt an, ob das Token für EWS- oder Outlook-REST-APIs benötigt wird. Standardmäßig ist die isRest Eigenschaft auf falsegesetzt.

callback

(asyncResult: Office.AsyncResult<Office.MailboxEnums.TokenStatus>) => void

Wenn die Methode abgeschlossen ist, wird die im callback Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResult aufgerufen. Die asyncResult.value Eigenschaft gibt den Status des Tokens zurück, bei dem es sich um ,Office.MailboxEnums.TokenStatus.Disabled oderOffice.MailboxEnums.TokenStatus.Removed handeln Office.MailboxEnums.TokenStatus.Enabledkann. Ein Office.MailboxEnums.TokenStatus.Removed Status gibt an, dass das Postfach in einer Exchange Online-Umgebung gehostet wird, in der Legacy-Exchange-Token deaktiviert sind und nicht mehr unterstützt werden.

Gibt zurück

void

Hinweise

API-Satz: Postfach 1.16

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Compose oder Lesen

Wichtig:

  • Die getTokenStatusAsync Methode wird nicht unterstützt, wenn Sie ein Add-In in ein Outlook.com- oder Gmail-Postfach laden.

  • Wenn Sie die getTokenStatusAsync Methode im Kompositionsmodus aufrufen, müssen Sie das Element gespeichert haben. Die saveAsync Methode erfordert eine Mindestberechtigungsstufe von Lese-/Schreibelementen.

getTokenStatusAsync(callback)

Ruft den Status von EWS-Rückruftoken in einer organization ab.

getTokenStatusAsync(callback: (asyncResult: Office.AsyncResult<MailboxEnums.TokenStatus>) => void): void;

Parameter

callback

(asyncResult: Office.AsyncResult<Office.MailboxEnums.TokenStatus>) => void

Wenn die Methode abgeschlossen ist, wird die im callback Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResult aufgerufen. Die asyncResult.value Eigenschaft gibt den Status des Tokens zurück, bei dem es sich um ,Office.MailboxEnums.TokenStatus.Disabled oderOffice.MailboxEnums.TokenStatus.Removed handeln Office.MailboxEnums.TokenStatus.Enabledkann. Ein Office.MailboxEnums.TokenStatus.Removed Status gibt an, dass das Postfach in einer Exchange Online-Umgebung gehostet wird, in der Legacy-Exchange-Token deaktiviert sind und nicht mehr unterstützt werden.

Gibt zurück

void

Hinweise

API-Satz: Postfach 1.16

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Compose oder Lesen

Wichtig:

  • Die getTokenStatusAsync Methode wird nicht unterstützt, wenn Sie ein Add-In in ein Outlook.com- oder Gmail-Postfach laden.

  • Wenn Sie die getTokenStatusAsync Methode im Kompositionsmodus aufrufen, müssen Sie das Element gespeichert haben. Die saveAsync Methode erfordert eine Mindestberechtigungsstufe von Lese-/Schreibelementen.