IMsgServiceAdmin::AdminProviders
Hace referencia a: Outlook 2013 | Outlook 2016
Devuelve un puntero que proporciona acceso a un objeto de administración del proveedor.
HRESULT AdminProviders(
LPMAPIUID lpUID,
ULONG ulFlags,
LPPROVIDERADMIN FAR * lppProviderAdmin
);
Parameters
lpUID
[in] Puntero a la estructura MAPIUID que contiene el identificador único del servicio de mensajes que se va a administrar.
ulFlags
[in] Siempre NULL.
lppProviderAdmin
[out] Puntero a un puntero a un objeto de administración del proveedor.
Valor devuelto
S_OK
El objeto de administración del proveedor se devolvió correctamente.
MAPI_E_NOT_FOUND
La MAPIUID a la que apunta lpUID no existe.
Comentarios
El método IMsgServiceAdmin::AdminProviders proporciona acceso a un objeto de administración del proveedor. Una administración del proveedor es un objeto que admite la interfaz IProviderAdmin y permite a los clientes hacer lo siguiente:
Agregar proveedores de servicios a un servicio de mensajes.
Eliminar proveedores de servicios de un servicio de mensajes.
Abra secciones de perfil.
Acceda a la tabla del proveedor de servicios de mensajes.
Los tipos de cambios que realmente se pueden realizar en un servicio de mensajes mientras el perfil está en uso dependen del servicio de mensajes. Sin embargo, la mayoría de los servicios de mensajes no admiten cambios como agregar y eliminar proveedores mientras el perfil está en uso.
Notas para los llamadores
Para recuperar la estructura MAPIUID para que el servicio de mensajes administre, recupere la columna de propiedad PR_SERVICE_UID (PidTagServiceUid) de la fila del servicio de mensajes en la tabla de servicio de mensajes. Para obtener más información, vea el procedimiento descrito en el método IMsgServiceAdmin::CreateMsgService .
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| MsgServiceTableDlg.cpp |
CMsgServiceTableDlg::OnDisplayItem |
MFCMAPI usa el método IMsgServiceAdmin::AdminProviders para abrir un objeto de administración de proveedor para un servicio. |