Informationen zur Frei/Gebucht-API
Die Frei/Gebucht-API ermöglicht es E-Mail-Anbietern, Frei/Gebucht-status Informationen für angegebene Benutzerkonten innerhalb eines angegebenen Zeitraums bereitzustellen. Die Frei/Gebucht-status eines Zeitblocks im Kalender eines Benutzers ist einer der folgenden: abwesenheitsfrei, beschäftigt, mit Vorbehalt oder frei.
Erstellen eines Frei/Gebucht-Anbieters
Um Frei/Gebucht-Informationen für E-Mail-Benutzer bereitzustellen, erstellt ein E-Mail-Anbieter einen Frei/Gebucht-Anbieter und registriert ihn bei Outlook. Der Frei/Gebucht-Anbieter muss die folgenden Schnittstellen implementieren. Beachten Sie, dass eine Reihe von Membern in diesen Schnittstellen nicht unterstützt werden und die angegebenen Rückgabewerte zurückgeben müssen. Insbesondere unterstützt die Frei/Gebucht-API keinen Schreibzugriff auf Frei/Gebucht-Informationen und den Delegieren des Zugriffs auf Konten.
IFreeBusySupport : Diese Schnittstelle unterstützt die Spezifikation von Schnittstellen, die für bestimmte Benutzer auf Frei/Gebucht-Daten zugreifen. Es verwendet FBUser , um einen Benutzer zu identifizieren.
IFreeBusyData – Diese Schnittstelle ruft einen Zeitbereich für einen bestimmten Benutzer ab und legt diesen fest und gibt eine Schnittstelle zum Aufzählen von Frei/Gebucht-Datenblöcken innerhalb dieses Zeitraums zurück. Es verwendet die relative Zeit, um diesen Zeitbereich abzurufen und festzulegen. Weitere Informationen finden Sie unter Verwenden der relativen Zeit für den Zugriff auf Frei/Gebucht-Daten.
IEnumFBBlock – Diese Schnittstelle unterstützt den Zugriff auf und das Aufzählen von Frei/Gebucht-Datenblöcken für einen Benutzer innerhalb eines Zeitbereichs.
Hinweis
Eine Enumeration enthält Frei/Gebucht-Blöcke, die die Frei/Gebucht-status von Zeiträumen im Kalender eines Benutzers innerhalb eines Zeitbereichs (angegeben durch IFreeBusyData::EnumBlocks) angeben. Elemente in einem Kalender, z. B. Termine und Besprechungsanfragen, bilden Blöcke in der Enumeration. Elemente, die im Kalender aneinander angrenzen und die gleiche Frei/Gebucht-status werden zu einem einzelnen Block kombiniert. Ein freier Zeitraum in einem Kalender bildet ebenfalls einen Block. Daher würden keine zwei aufeinander folgenden Blöcke in einer Enumeration den gleichen Frei/Gebucht-status. Diese Blöcke überlappen sich nicht in der Zeit. Wenn sich in einem Kalender überlappende Elemente vorhanden sind, führt Outlook diese Elemente zu nicht überlappenden Frei/Gebucht-Blöcken in der Enumeration basierend auf dieser Rangfolge zusammen: Abwesenheit, Beschäftigt, Mit Vorbehalt.
Um den Frei/Gebucht-Anbieter bei Outlook zu registrieren, sollte der E-Mail-Anbieter die folgenden Schritte ausführen:
Registrieren Sie den Frei/Gebucht-Anbieter bei COM, und geben Sie eine CLSID an, die den Zugriff auf die Implementierung von IFreeBusySupport durch den Anbieter ermöglicht.
Informieren Sie Outlook, dass der Frei/Gebucht-Anbieter vorhanden ist, indem Sie den folgenden Schlüssel (wobei
<xx.x>die Version von Outlook darstellt) in der Systemregistrierung festlegen:HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\<xx.x>\Outlook\SchedulingInformation\FreeBusySupportWenn der Transportanbieter beispielsweise SMTP ist, legen Sie zum Registrieren des Anbieters bei Microsoft Outlook 2010 den folgenden Schlüssel für die Daten in der folgenden Tabelle fest:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\14.0\Outlook\SchedulingInformation\FreeBusySupportName Typ Wert SMTP REG_SZ {CLSID für die jeweilige Implementierung von IFreeBusySupport} In diesem Szenario erstellt Outlook die COM-Klasse gemeinsam und verwendet sie zum Abrufen von Frei/Gebucht-Informationen für alle SMTP-E-Mail-Benutzer.
Um ein Adressbuch und einen Transportanbieter zu unterstützen, die einen anderen Adresseintragstyp als SMTP verwenden, ändern Sie den Namen entsprechend.
Hinweis
Während der Installation sollten Frei/Gebucht-Anbieter überprüfen, ob bereits eine Registrierungseinstellung für denselben Adresseintragstyp vorhanden ist. Wenn dies der Fall ist, sollte der Frei/Gebucht-Anbieter den aktuellen Anbieter für diesen Adresseintragstyp überschreiben und bei der Deinstallation für diesen Anbieter wiederherstellen. Wenn ein Benutzer jedoch mehr als einen Frei/Gebucht-Anbieter für denselben Adresseintragstyp installiert hat, sollte der Benutzer diese Anbieter in der umgekehrten Reihenfolge als Installation deinstallieren (das heißt, immer den neuesten Anbieter deinstallieren). Andernfalls verweist die Registrierung möglicherweise auf einen Anbieter, der bereits deinstalliert wurde.
API-Komponenten
Die Frei/Gebucht-API umfasst die folgenden Komponenten: