IABLogon::GetOneOffTable
Hace referencia a: Outlook 2013 | Outlook 2016
Devuelve una tabla de plantillas únicas para crear destinatarios que se agregarán a la lista de destinatarios de un mensaje saliente.
HRESULT GetOneOffTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Parameters
ulFlags
[in] Máscara de bits de marcas que controla el tipo de columnas de cadena incluidas en la tabla. 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.
MAPI_E_BAD_CHARWIDTH
Se estableció la marca de MAPI_UNICODE y el proveedor de libreta de direcciones no admite Unicode, o MAPI_UNICODE no se estableció y el proveedor de libreta de direcciones solo admite Unicode.
MAPI_E_NO_SUPPORT
El proveedor de libreta de direcciones no proporciona ninguna plantilla única.
Comentarios
MAPI llama al método GetOneOffTable para que las plantillas únicas estén disponibles para crear destinatarios. Los nuevos destinatarios se agregan a la lista de destinatarios de un mensaje saliente. Los proveedores de libreta de direcciones deben admitir la notificación en su tabla única para informar a MAPI de las modificaciones de plantilla. MAPI mantiene abierta la tabla única para habilitar la actualización dinámica.
Los proveedores de libretas de direcciones también pueden admitir una tabla única para cada uno de sus contenedores. Los llamadores recuperan esta tabla única llamando al método IMAPIProp::OpenProperty del contenedor y solicitando la propiedad PR_CREATE_TEMPLATES (PidTagCreateTemplates). Las plantillas disponibles a través de esta tabla se usan para agregar destinatarios al contenedor. Para obtener una explicación de las diferencias entre los dos tipos de tablas únicas, consulte Implementación de tablas One-Off.
Para obtener una lista de las columnas necesarias en la tabla única de un proveedor de libreta de direcciones, consulte Tablas de uso único.