IProviderAdmin::CreateProvider
Hace referencia a: Outlook 2013 | Outlook 2016
Agrega un proveedor de servicios al servicio de mensajes.
HRESULT CreateProvider(
LPSTR lpszProvider,
ULONG cValues,
LPSPropValue lpProps,
ULONG_PTR ulUIParam,
ULONG ulFlags,
MAPIUID FAR * lpUID
);
Parameters
lpszProvider
[in] Puntero al nombre del proveedor que se va a agregar.
cValues
[in] Recuento de valores de propiedad a los que apunta el parámetro lpProps .
lpProps
[in] Puntero a una matriz de valores de propiedad que describe las propiedades del proveedor que se van a agregar.
ulUIParam
[in] Identificador de la ventana primaria de los cuadros de diálogo o ventanas que muestra este método. El parámetro ulUIParam se usa si la marca de MAPI_DIALOG se establece en el parámetro ulFlags .
ulFlags
[in] Máscara de bits de marcas que controla la adición del proveedor. Se pueden establecer las siguientes marcas:
MAPI_DIALOG: muestra un cuadro de diálogo para solicitar información de configuración.
MAPI_UNICODE: el nombre del proveedor y las propiedades de cadena están en formato Unicode. Si no se establece la marca de MAPI_UNICODE, estas cadenas están en formato ANSI.
lpUID
[out] Puntero a la estructura MAPIUID que contiene el identificador único que representa el proveedor que se va a agregar.
Valor devuelto
S_OK
El proveedor se agregó correctamente al servicio de mensajes.
MAPI_E_USER_CANCEL
El usuario canceló la operación, normalmente haciendo clic en el botón Cancelar de un cuadro de diálogo.
Comentarios
El método IProviderAdmin::CreateProvider agrega un proveedor de servicios al servicio de mensajes. El parámetro lpszProvider debe apuntar al nombre de un proveedor que pertenece al servicio de mensajes. CreateProvider no comprueba si el nombre coincide con el nombre de un proveedor en el servicio; Si el nombre pasado no coincide con un nombre de servicio, la llamada se realiza correctamente, pero los resultados son impredecibles. La mayoría de los servicios de mensajes no permiten que los proveedores se agreguen o eliminen mientras el perfil está en uso.
Después de agregar toda la información disponible sobre el proveedor de servicios al perfil desde el archivo Mapisvc.inf, CreateProvider llama a la función de punto de entrada del servicio de mensajes con el parámetro ulContext establecido en MSG_SERVICE_PROVIDER_CREATE. Si MAPI_DIALOG se establece en el parámetro ulFlags del método CreateProvider, los valores de los parámetros ulUIParam y ulFlags también se pasan a la función de punto de entrada. Estos parámetros adicionales permiten al proveedor de servicios mostrar su hoja de propiedades para que el usuario pueda especificar la configuración.