Office.Ews interface

Paket:
outlook

Stellt Methoden bereit, mit denen ermittelt werden kann, ob EWS-Rückruftoken (Exchange-Webdienste) in einem organization unterstützt werden.

Hinweise

API-Satz: Postfach 1.16

Mindestberechtigungsstufe: Element lesen

Anwendbarer Outlook-Modus: Compose oder Lesen

Wichtig: Legacy-Exchange Online Benutzeridentitätstoken und Rückruftoken werden nicht mehr unterstützt und für alle Microsoft 365-Mandanten deaktiviert. Wenn ein Outlook-Add-In delegierten Benutzerzugriff oder eine Benutzeridentität erfordert, empfehlen wir die Verwendung von MSAL (Microsoft Authentication Library (MSAL)) und geschachtelter App-Authentifizierung (NAA). Exchange-Benutzeridentitätstoken werden für lokale Exchange-Instanzen 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 die status von EWS-Rückruftoken in einem organization ab.
getTokenStatusAsync(callback)

Ruft die status von EWS-Rückruftoken in einem organization ab.

Details zur Methode

getTokenStatusAsync(options, callback)

Ruft die status von EWS-Rückruftoken in einem 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 erforderliche Token für EWS- oder Outlook-REST-APIs verwendet wird. Standardmäßig ist die isRest -Eigenschaft auf falsefestgelegt.

callback

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

Nach Abschluss der Methode wird die im callback Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResult aufgerufen. Die asyncResult.value -Eigenschaft gibt das Token status zurück, das ,Office.MailboxEnums.TokenStatus.Disabled oderOffice.MailboxEnums.TokenStatus.Removed sein 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 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 Verfassenmodus aufrufen, müssen Sie das Element gespeichert haben. Die saveAsync -Methode erfordert eine Mindestberechtigungsstufe für Lese-/Schreibzugriff.

getTokenStatusAsync(callback)

Ruft die status von EWS-Rückruftoken in einem organization ab.

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

Parameter

callback

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

Nach Abschluss der Methode wird die im callback Parameter übergebene Funktion mit einem einzelnen Parameter vom Typ Office.AsyncResult aufgerufen. Die asyncResult.value -Eigenschaft gibt das Token status zurück, das ,Office.MailboxEnums.TokenStatus.Disabled oderOffice.MailboxEnums.TokenStatus.Removed sein 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 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 Verfassenmodus aufrufen, müssen Sie das Element gespeichert haben. Die saveAsync -Methode erfordert eine Mindestberechtigungsstufe für Lese-/Schreibzugriff.