WIZARDENTRY
Область применения: Outlook 2013 | Outlook 2016
Определяет функцию точки входа поставщика услуг, которая вызывается мастером профилей для получения достаточного количества сведений для отображения листов свойств конфигурации поставщика.
| Свойство | Значение |
|---|---|
| Файл заголовка: |
Mapiwz.h |
| Определена функция, реализованная: |
Поставщики служб |
| Определенная функция, вызываемая: |
Мастер профилей MAPI |
ULONG WIZARDENTRY(
HINSTANCE hProviderDLLInstance,
LPSTR FAR * lpcsResourceName,
DLGPROC FAR * lppDlgProc,
LPMAPIPROP lpMAPIProp,
LPMAPISUPPORTOBJECT lpMapiSupportObject
);
Параметры
hProviderDLLInstance
[в] Дескриптор экземпляра DLL поставщика услуг.
lpcsResourceName
[out] Указатель на строку, содержащую полное имя ресурса диалогового окна, которое должно отображаться мастером профилей во время настройки. Максимальный размер строки, включая символ конца NULL, составляет 32 символа.
lppDlgProc
[out] Указатель на стандартную процедуру диалогового окна Windows, которая будет вызываться мастером профилей для уведомления поставщика о различных событиях.
lpMAPIProp
[в] Указатель на реализацию интерфейса свойства, которая предоставляет доступ к свойствам конфигурации.
lpMapiSupportObject
[в] Указатель на объект поддержки MAPI, применимый к этому сеансу.
Возвращаемое значение
S_OK
Функция WIZARDENTRY поставщика услуг была вызвана успешно.
MAPI_E_CALL_FAILED
Ошибка непредвиденного или неизвестного происхождения помешала завершению операции.
Замечания
Мастер профилей вызывает функцию на основе WIZARDENTRY , когда она готова к отображению пользовательского интерфейса конфигурации поставщика услуг. Когда мастер профилей завершит настройку всех поставщиков, он записывает свойства конфигурации в профиль, вызывая IMsgServiceAdmin::ConfigureMsgService.
Примечания для исполнителей
Имя функции на основе WIZARDENTRY должно быть помещено в запись WIZARD_ENTRY_NAME в MAPISVC.INF.
Имя ресурса — это имя ресурса диалогового окна, который будет отображаться в области мастера профилей. Ресурс, который передается обратно, должен содержать все страницы в одном ресурсе диалогового окна. Когда мастер профилей получает этот ресурс, он игнорирует стиль диалога, но не стили элементов управления, и создает все элементы управления как дочерние элементы страницы мастера профилей. Все элементы управления изначально скрыты. Поставщики должны убедиться, что координаты для своих элементов управления основаны на нулях или от нуля и не превышают максимальную ширину в 200 диалоговых единиц и максимальную высоту в 150 диалоговых единиц. Идентификаторы элементов управления ниже 400 зарезервированы для мастера профилей. Мастер профилей отображает заголовок поставщика полужирным шрифтом над пользовательским интерфейсом поставщика.
Указатель интерфейса свойства, указанный в параметре lpMAPIProp , должен храниться поставщиком для дальнейшего использования. Мастер профилей работает только с самым базовым набором свойств, и поставщик может использовать реализацию интерфейса свойств для включения дополнительных свойств. Во время настройки поставщики должны добавить свои свойства конфигурации в объект, реализуя интерфейс свойства. После настройки всех поставщиков мастер профилей добавляет эти свойства в профиль.
Дополнительные сведения об использовании этой функции см. в разделе Поддержка конфигурации службы сообщений.