IMAPISupport::GetOneOffTable
Hace referencia a: Outlook 2013 | Outlook 2016
Devuelve un puntero a la tabla única MAPI (una lista de plantillas que todos los proveedores de libreta de direcciones admiten para crear nuevos destinatarios).
HRESULT GetOneOffTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Parameters
ulFlags
[in] Máscara de bits de marcas que controla el tipo de las columnas de cadena. Se puede establecer la marca siguiente:
MAPI_UNICODE
Las columnas de cadena están en formato Unicode. Si no se establece la marca de MAPI_UNICODE, las columnas de cadena están en formato ANSI.
lppTable
[out] Puntero a un puntero a la tabla única.
Valor devuelto
S_OK
La tabla única se recuperó correctamente.
Comentarios
El método IMAPISupport::GetOneOffTable se implementa para los objetos de compatibilidad del proveedor de libretas de direcciones. Los proveedores de libreta de direcciones llaman a GetOneOffTable para recuperar la lista completa de plantillas para crear nuevos destinatarios. En esta tabla se incluyen plantillas que abordan proveedores de libretas que están activos en la compatibilidad con la sesión, así como plantillas compatibles con MAPI.
Los destinatarios recién creados se pueden usar para dirigir un mensaje o se pueden agregar a un contenedor de libreta de direcciones.
Para obtener una lista de las propiedades que componen el conjunto de columnas necesario en tablas únicas, consulte Tablas de uso único.
Establecer la marca MAPI_UNICODE en el parámetro ulFlags afecta al formato de las columnas devueltas por los métodos IMAPITable::QueryColumns e IMAPITable::QueryRows . Esta marca también controla los tipos de propiedad en el criterio de ordenación devuelto por el método IMAPITable::QuerySortOrder .
Notas para los llamadores
Si está registrado para recibir notificaciones de cambios en esta tabla única, también recibirá notificaciones de cambios en las tablas únicas de otros proveedores. En función de estas notificaciones, puede admitir nuevos tipos de direcciones que se agregan durante la sesión actual.