IABLogon::GetOneOffTable
Gilt für: Outlook 2013 | Outlook 2016
Gibt eine Tabelle mit einmaligen Vorlagen zum Erstellen von Empfängern zurück, die der Empfängerliste einer ausgehenden Nachricht hinzugefügt werden sollen.
HRESULT GetOneOffTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Parameter
ulFlags
[in] Eine Bitmaske von Flags, die den Typ der in der Tabelle enthaltenen Zeichenfolgenspalten steuert. Das folgende Flag kann festgelegt werden:
MAPI_UNICODE
Die Zeichenfolgenspalten weisen das Unicode-Format auf. Wenn das MAPI_UNICODE-Flag nicht festgelegt ist, liegen die Zeichenfolgenspalten im ANSI-Format vor.
lppTable
[out] Ein Zeiger auf einen Zeiger auf die einmalige Tabelle.
Rückgabewert
S_OK
Die einmalige Tabelle wurde erfolgreich abgerufen.
MAPI_E_BAD_CHARWIDTH
Entweder wurde das flag MAPI_UNICODE festgelegt, und der Adressbuchanbieter unterstützt Unicode nicht, oder MAPI_UNICODE wurde nicht festgelegt und der Adressbuchanbieter unterstützt nur Unicode.
MAPI_E_NO_SUPPORT
Der Adressbuchanbieter stellt keine einmaligen Vorlagen bereit.
Hinweise
MAPI ruft die GetOneOffTable-Methode auf, um einmalige Vorlagen zum Erstellen von Empfängern verfügbar zu machen. Die neuen Empfänger werden der Empfängerliste einer ausgehenden Nachricht hinzugefügt. Adressbuchanbieter sollten Benachrichtigungen für ihre einmalige Tabelle unterstützen, um MAPI über Vorlagenänderungen zu informieren. MAPI hält die einmalige Tabelle geöffnet, um dynamische Updates zu ermöglichen.
Adressbuchanbieter können auch eine einmalige Tabelle für jeden ihrer Container unterstützen. Aufrufer rufen diese einmalige Tabelle ab, indem sie die IMAPIProp::OpenProperty-Methode des Containers aufrufen und die eigenschaft PR_CREATE_TEMPLATES (PidTagCreateTemplates) anfordern. Die über diese Tabelle verfügbaren Vorlagen werden verwendet, um dem Container Empfänger hinzuzufügen. Eine Erläuterung der Unterschiede zwischen den beiden Typen von einmaligen Tabellen finden Sie unter Implementieren von One-Off Tabellen.
Eine Liste der erforderlichen Spalten in der einmaligen Tabelle eines Adressbuchanbieters finden Sie unter Einmalige Tabellen.