Información sobre la API de disponibilidad
La API de disponibilidad permite a los proveedores de correo proporcionar información de estado de disponibilidad para las cuentas de usuario especificadas dentro de un intervalo de tiempo especificado. El estado de disponibilidad de un bloque de tiempo en el calendario de un usuario es uno de los siguientes: fuera de la oficina, ocupado, provisional o libre.
Creación de un proveedor de disponibilidad
Para proporcionar información de disponibilidad a los usuarios de correo, un proveedor de correo crea un proveedor de disponibilidad y la registra en Outlook. El proveedor de disponibilidad debe implementar las siguientes interfaces. Tenga en cuenta que no se admiten varios miembros de estas interfaces y que deben devolver los valores devueltos especificados. En concreto, la API de disponibilidad no admite el acceso de escritura a la información de disponibilidad ni el acceso delegado a las cuentas.
IFreeBusySupport : esta interfaz admite la especificación de interfaces que acceden a datos de disponibilidad para usuarios especificados. Usa FBUser para identificar a un usuario.
IFreeBusyData : esta interfaz obtiene y establece un intervalo de tiempo para un usuario determinado y devuelve una interfaz para enumerar bloques de datos de disponibilidad dentro de este intervalo de tiempo. Usa el tiempo relativo para obtener y establecer este intervalo de tiempo. Para obtener más información, consulte Uso del tiempo relativo para acceder a datos de disponibilidad.
IEnumFBBlock : esta interfaz admite el acceso y la enumeración de bloques de datos de disponibilidad para un usuario dentro de un intervalo de tiempo.
Nota:
Una enumeración contiene bloques de disponibilidad que indican el estado de disponibilidad de períodos de tiempo en el calendario de un usuario, dentro de un intervalo de tiempo (especificado por IFreeBusyData::EnumBlocks). Elementos de un calendario, como citas y convocatorias de reunión, bloques de formulario de la enumeración. Los elementos adyacentes entre sí en el calendario y que tienen el mismo estado de disponibilidad se combinan para formar un único bloque. Un período de tiempo libre en un calendario también forma un bloque. Por lo tanto, no hay dos bloques consecutivos en una enumeración que tengan el mismo estado de disponibilidad. Estos bloques no se superponen a tiempo. Cuando hay elementos superpuestos en un calendario, Outlook combina estos elementos para formar bloques de disponibilidad no superpuestos en la enumeración en función de este orden de precedencia: fuera de la oficina, ocupado, provisional.
Para registrar el proveedor de disponibilidad con Outlook, el proveedor de correo debe hacer lo siguiente:
Registre el proveedor de disponibilidad con COM, proporcionando un CLSID que permita el acceso a la implementación del proveedor de IFreeBusySupport.
Para que Outlook sepa que el proveedor de disponibilidad existe, establezca la siguiente clave (donde
<xx.x>representa la versión de Outlook) en el registro del sistema:HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\<xx.x>\Outlook\SchedulingInformation\FreeBusySupportPor ejemplo, si el proveedor de transporte es SMTP, para registrar el proveedor con Microsoft Outlook 2010, establezca la clave siguiente en los datos de la tabla siguiente:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\14.0\Outlook\SchedulingInformation\FreeBusySupportNombre Tipo Valor SMTP REG_SZ {CLSID para la implementación respectiva de IFreeBusySupport} En este escenario, Outlook crea conjuntamente la clase COM y la usa para recuperar información de disponibilidad para cualquier usuario de correo SMTP.
Para admitir una libreta de direcciones y un proveedor de transporte que usen un tipo de entrada de dirección distinto de SMTP, cambie el nombre en consecuencia.
Nota:
Durante la instalación, los proveedores de disponibilidad deben comprobar si ya existe una configuración del Registro para el mismo tipo de entrada de dirección. Si lo hace, el proveedor de disponibilidad debe sobrescribir el proveedor actual para ese tipo de entrada de dirección y restaurarlo en ese proveedor cuando se desinstale. Sin embargo, si un usuario ha instalado más de un proveedor de disponibilidad para el mismo tipo de entrada de dirección, el usuario debe desinstalar estos proveedores en el orden inverso como instalación (es decir, desinstalar siempre el proveedor más reciente). De lo contrario, el registro puede apuntar a un proveedor que ya se ha desinstalado.
Componentes de API
La API de disponibilidad incluye los siguientes componentes: