IMAPISupport::GetOneOffTable
Gilt für: Outlook 2013 | Outlook 2016
Gibt einen Zeiger auf die einmalige MAPI-Tabelle zurück (eine Liste von Vorlagen, die alle Adressbuchanbieter zum Erstellen neuer Empfänger unterstützen).
HRESULT GetOneOffTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Parameter
ulFlags
[in] Eine Bitmaske von Flags, die den Typ der 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.
Hinweise
Die IMAPISupport::GetOneOffTable-Methode wird für Adressbuchanbieterunterstützungsobjekte implementiert. Adressbuchanbieter rufen GetOneOffTable auf, um die vollständige Liste der Vorlagen zum Erstellen neuer Empfänger abzurufen. Diese Tabelle enthält Vorlagen für Adressbuchanbieter, die in der Sitzungsunterstützung aktiv sind, sowie Vorlagen, die MAPI unterstützt.
Die neu erstellten Empfänger können verwendet werden, um eine Nachricht zu adressieren oder einem Adressbuchcontainer hinzugefügt werden.
Eine Liste der Eigenschaften, aus denen der erforderliche Spaltensatz in einmaligen Tabellen besteht, finden Sie unter Einmalige Tabellen.
Das Festlegen des MAPI_UNICODE-Flags im ulFlags-Parameter wirkt sich auf das Format der Spalten aus, die von den Methoden IMAPITable::QueryColumns und IMAPITable::QueryRows zurückgegeben werden. Dieses Flag steuert auch die Eigenschaftstypen in der Sortierreihenfolge, die von der IMAPITable::QuerySortOrder-Methode zurückgegeben wird.
Hinweise für Aufrufer
Wenn Sie registriert sind, um Benachrichtigungen über Änderungen an dieser einmaligen Tabelle zu erhalten, erhalten Sie auch Benachrichtigungen über Änderungen an einmaligen Tabellen anderer Anbieter. Basierend auf diesen Benachrichtigungen können Sie neue Adresstypen unterstützen, die während der aktuellen Sitzung hinzugefügt werden.